SHIP:Node:box

Node Home

The box node is the generic container used to position and enclose other visual elements. They can be nested, stacked, and overlapped. Touch events can be sensed within them. They can be invisible, partially tranparent, or fully opaque. And they have all the properties of the Box Model, including margin, borders, padding, and more.

box nodes can exist in the layout area or the resources area. In the resources area, the box forms a template of properties that can be inherited by a box in the layout area.

Parent Nodes

The following nodes are permitted to hold this node:

• box
• group
• page

Child Nodes

The following nodes are permitted to exist within this node:

• box
• constant
• group
• listener
• text
• timer
• variable

Properties

The following Box Model properties are available for the box node:

Box Model Outer Properties

Property	Data Type	Description
ot	Dimension	Top edge of a box model node.
ob	Dimension	Bottom edge of a box model node.
oh	Dimension	Height of a box model node.
ol	Dimension	Left edge of a box model node.
or	Dimension	Right edge of a box model node.
ow	Dimension	Width of a box model node.

Box Model Vertical and Horizontal Alignment Properties

Property	Data Type	Description
valign	VALIGN	Vertical alignment of a box model node within its parent container's inner dimensions.
halign	HALIGN	Horizontal alignment a box model node within its parent container's inner dimensions.

Box Model Margin Properties

Property	Data Type	Description
mt	Dimension	Top margin thickness of a box; not present on lightweight box model nodes such as frame and textframe.
mb	Dimension	Bottom margin width of a box; not present on lightweight box model nodes such as frame and textframe.
ml	Dimension	Left margin width of a box; not present on lightweight box model nodes such as frame and textframe
mr	Dimension	Right margin width of a box; not present on lightweight box model nodes such as frame and textframe

Box Model Border Properties

Property	Data Type	Description
bt	Dimension	Top border thickness of a box; not present on lightweight box model nodes such as frame and textframe.
bct	Color	Top border color of a box; not present on lightweight box model nodes such as frame and textframe.
bb	Dimension	Bottom border thickness of a box; not present on lightweight box model nodes such as frame and textframe.
bcb	Color	Bottom border color of a box; not present on lightweight box model nodes such as frame and textframe.
bl	Dimension	Left border thickness of a box; not present on lightweight box model nodes such as frame and textframe.
bcl	Color	Left border color of a box; not present on lightweight box model nodes such as frame and textframe.
br	Dimension	Right border thickness of a box; not present on lightweight box model nodes such as frame and textframe.
bcr	Color	Right border color of a box; not present on lightweight box model nodes such as frame and textframe.

Box Model Padding Properties

Property	Data Type	Description
pt	Dimension	Top padding thickness of a box; not present on lightweight box model nodes such as frame and textframe.
pb	Dimension	Bottom padding thickness of a box; not present on lightweight box model nodes such as frame and textframe.
pl	Dimension	Left padding thickness of a box; not present on lightweight box model nodes such as frame and textframe.
pr	Dimension	Right padding thickness of a box; not present on lightweight box model nodes such as frame and textframe.

Box Model Inner Dimension Properties

Property	Data Type	Description
it	Dimension	Inner area top coordinate of a box model node relative to the display.
ib	Dimension	Inner area bottom coordinate of a box model node relative to the display.
ih	Dimension	Inner area height of a box model node.
il	Dimension	Inner area left coordinate of a box model node relative to the display.
ir	Dimension	Inner area right coordinate of a box model node, relative to the display.
iw	Dimension	Inner area width of a box model node.

Box Model Background, Fill, Inner Color Properties

Property	Data Type	Description
bgcolor	Color	Background color of a Box Model Node, filling the container completely to the outer edges.
fillcolor	Color	Fill color of a box, filling the box completely within the margin area; not present on lightweight box model nodes such as frame and textframe.
innercolor	Color	Inner color of a box, filling the box completely within the inner area after padding is applied; not present on lightweight box model nodes such as frame and textframe.

Box Model Attached Image/Canvas Offset Properties

Property	Data Type	Description
xoffset	Dimension	The horizontal offset of an attached image or canvas within the inner area of a a Box Model Node. May be positive or negative or 0.
yoffset	Dimension	The vertical offset of an attached image or canvas within the inner area of a a Box Model Node. May be positive or negative or 0.