MWAPI - SCROLL

Draft MDC Standard

SCROLL specifies scrolling behavior for a gadget’s data.

If the value of the hsize component of SCROLL is greater than 0 (zero), horizontal scrolling can occur to reveal horizontal coordinates from 0 to hsize. If the value of the hsize component of SCROLL is equal to 0 (zero), horizontal scrolling can occur but no explicit horizontal range is specified for the data. If hsize is omitted, horizontal scrolling cannot occur.

If the value of the vsize component of SCROLL is greater than 0 (zero), vertical scrolling can occur to reveal vertical coordinates from 0 to vsize. If the value of the vsize component of SCROLL is equal to 0 (zero), vertical scrolling can occur but no explicit vertical range is specified for the data. If vsize is omitted, vertical scrolling cannot occur.

The unit of measure is determined in the same manner as is specified for the SIZE elattribute.

For a document gadget, the hsize component of SCROLL also specifies the width at which wrapping occurs.

A scroll bar may or may not be present when it is not required.

If an application attempts to assign a SCROLL value that contains a negative value for hsize or vsize, an error occurs with an ecode = "M47" and $EREF containing a value that indicates the ssvn reference for which the error occurred.