MWAPI - SIZE

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

SIZE specifies the size of the gadget, expressed in the unit of measure defined by the unitspec component of the size value, if present, and by the gadget’s UNITS elattribute otherwise.

If the unit of measure is not CHAR and a gadget is rectangular, SIZE specifies the overall size of the gadget. If the unit of measure is not CHAR and a gadget is not rectangular, SIZE specifies the size of the smallest rectangle that can bound the gadget.

If the unit of measure is CHAR, the basis font is the font specified by the gadget’s FFACE, FSIZE and FSTYLE elattributes. For a check box, document, label, list box, list button, list entry box, long list box, push button, radio button set, or text gadget, if the unit of measure is CHAR, the gadget is large enough to accommodate vsize lines of hsize characters each using the basis font; the overall size of the gadget may be larger. For other gadget types, a unit of measure of CHAR specifies the overall size of the gadget.

If the unit of measure is REL, the basis size is the size of the parent’s window viewport when the parent is created.

For a group frame, hsize and vsize values greater than 0 (zero) produce a rectangle; an hsize value of 0 (zero) produces a vertical line; a vsize value of 0 (zero) produces a horizontal line. If an application attempts to assign to the SIZE elattribute of a group frame a size value for which hsize and vsize are both 0 (zero), an error condition occurs with $ECODE containing ",M?2," and $EREF containing a value that indicates the ssvn reference for which the error occurred.

For a generic box or group frame gadget, if a value is not assigned to the SIZE elattribute when the gadget is created, an error condition occurs with $ECODE containing ",M?7", and $EREF containing a value that indicates the ssvn reference for which the error occurred.

Whenever a size value specifies the overall size of a gadget, the size includes the gadget’s border, if any. For a check box, label or push button gadget, the overall size of a gadget includes the gadget’s title, if any. For a document, list box, list button, list entry box, long list box, radio button set or text gadget, the overall size of a gadget excludes the gadget’s title, if any. For a group frame, the overall size of a gadget may exclude the gadget’s title, if any.

For a list button, size includes the size of the button and the list. The actual height of the list button gadget may be whatever is required to contain the choices and some platforms may not allow the list to be scrolled.

Assigning a value to the SIZE elattribute for a gadget does not imply any automatic scaling of the gadget’s contents.

When an application assigns a value to the SIZE elattribute of an existing gadget, if hsize or vsize is not specified then the horizontal or vertical size of the gadget, respectively, is not altered.