MWAPI - GRID

Draft MDC Standard

In conjunction with descendant nodes GRID defines the properties of a reference grid for the placement of gadgets on a build-mode window.

For a window in build mode, GRID defines the size of one rectangle in the grid. If the unit of measure is CHAR, the basis font is the font specified by the window’s FFACE, FSIZE and FSTYLE wattributes. If the unit of measure is REL, the basis size is the size most recently assigned to the SIZE wattribute. If either of the hsize or vsize components of GRID is zero, the grid dimension corresponding to that component is one pixel but no grid is visible.

Descendant nodes are of the form

^$W[INDOW] ( wname , gridkeyword , gridattr )

where

The SNAPPOS gridattr determines how gadgets behave when moved. If TRUE, when a single gadget is moved by user action that gadget’s position is adjusted to coincide with the nearest point on the grid, and when a group of gadgets is moved the origin of the group’s bounding rectangle is adjusted to coincide with the nearest point on the grid. If FALSE, no adjustment of position occurs.

The SNAPSIZE gridattr determines how a gadget behaves when resized. If TRUE, when a gadget is resized by user action edge or edges being resized are adjusted to coincide with the nearest point on the grid in the corresponding dimension. If FALSE, no adjustment of size occurs.

The VISIBLE gridattr determines visibility of the grid. If TRUE, a grid is visible on the window, so long as both dimensions of the grid’s size are positive. Appearance of the grid is platform-dependent. If FALSE, no grid is shown.

For a window that is not in build mode, the node and its descendants may be set and referenced but are ignored.