MWAPI - SIZE

Draft MDC 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. If the FFACE elattribute is not applicable to the gadget, the basis font is the font specified by the gadget’s TFFACE, TFSIZE and TFSTYLE elattributes. If the TFFACE elattribute is not applicable to the gadget, the basis font is the font specified by the parent window’s FFACE, FSIZE and FSTYLE wattributes. 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 an ecode = "M47" 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 an ecode = "M52" and $EREF containing a value that indicates the ssvn reference for which the error occurred.

For a generic box or group frame gadget, if an application attempts to assign to the SIZE elattribute a value which does not contain both an hsize component and a vsize component, an error condition occurs with an ecode = "M47" 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.

For a symbol gadget, if the SIZE elattribute value assigned by an application is smaller than the size necessary to display the image specified for the gadget, the image is cropped. If the SIZE elattribute value assigned by an application is larger than the size necessary to display the image specified for the gadget, the image may be stretched to fit the assigned size or the gadget’s size may be reduced to the actual size necessary to display the image.

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.