VisComp: 2.5 VisCompClass Instance Data: VCI_geoDimensionAttrs

The VCI_geoDimensionAttrs field determines how the composite manages its children in each dimension. It provides the geometry information not given in VCI_geoAttrs such as child justification and certain sizing behavior.

It contains three fields for each dimension (horizontal and vertical): The first field represents the justification of the children in that dimension. This field is two bits and can be one of four different enumerations. The second and third fields are sizing flags. These fields are listed below:

VCGDA_WIDTH_JUSTIFICATION: This is a two-bit field that can be set to any one of four possible width justifications. If the name of this field is used in place of one of the four values, full justification will be used. The justification can be set as a normal flag. The four different values are
: WJ_LEFT_JUSTIFY_CHILDREN
Left justify the children.
WJ_RIGHT_JUSTIFY_CHILDREN: Right justify the children.
WJ_CENTER_CHILDREN_HORIZONTALLY: Center the children horizontally.
WJ_FULL_JUSTIFY_CHILDREN_HORIZONTALLY: Full justify the children. Horizontal full justification is only meaningful if the children are oriented horizontally (by clearing VCGA_ORIENT_CHILDREN_VERTICALLY in VCI_geoAttrs ).
VCGDA_EXPAND_WIDTH_TO_FIT_PARENT: If this flag is set, the composite will try to expand to fill the available width of its parent. By default, this flag is not set; the composite will be only as wide as its children require.
VCGDA_DIVIDE_WIDTH_EQUALLY: If this flag is set, the composite will try to divide space equally between all its manageable, horizontally-oriented children. The composite will only suggest sizes--the children may or may not cooperate.
VCGDA_HEIGHT_JUSTIFICATION: This is a two-bit field that can be set to any one of four height justifications. If the name of this field is used in place of one of the four values, full justification will be used. The justification can be set as a normal flag. The four different values are
: HJ_TOP_JUSTIFY_CHILDREN
Justify the children to the composite's top bound.
HJ_BOTTOM_JUSTIFY_CHILDREN: Justify the children to the composite's bottom bound.
HJ_CENTER_CHILDREN_VERTICALLY: Center the children vertically.
HJ_FULL_JUSTIFY_CHILDREN_VERTICALLY: Full justify the children. Vertical full justification is only meaningful if the children are oriented vertically (by setting VCGA_ORIENT_CHILDREN_VERTICALLY in VCI_geoAttrs ).
VCGDA_EXPAND_HEIGHT_TO_FIT_PARENT: If this flag is set, the composite will try to expand to fill the available height of its parent. By default, this flag is not set; the composite will be only as tall as its children require.
VCGDA_DIVIDE_HEIGHT_EQUALLY: If this flag is set, the composite will try to divide space equally between all its manageable, vertically-oriented children. The composite will only suggest sizes--the children may or may not cooperate .

GEOS SDK TechDocs |

2.4 VCI_geoAttrs | Next:

2.6 Managing Instance Data