Matrix Field Properties
All the properties for matrix fields are described under (see
Common Field Properties), with the exception of the following properties or values that are specific to the matrix field type:
ChildBottomMargin
Specifies the bottom margin (in 1000ths of an inch) around each child field within the composite field and between the child field and the bottom boundary of the composite field
ChildGravity
Specifies the default position of each child field relative to its cell in the composite field. Valid alignment options are:
FA_DEFAULT (system default value)
FA_NONE
FA_TOPCENTER
FA_TOPLEFT
FA_TOPRIGHT
FA_CENTERLEFT
FA_CENTER
FA_CENTERRIGHT
FA_BOTTOMCENTER
FA_BOTTOMLEFT
FA_BOTTOMRIGHT
For more information about the Gravity and ChildGravity properties, see the Gravity section under
Common Field Properties.
ChildLeftMargin
Specifies the left margin (in 1000ths of an inch) around each child field within the composite field and between the child field and the left boundary of the composite field
ChildRightMargin
Specifies the right margin (in 1000ths of an inch) around each child field within the composite field and between the child field and the right boundary of the composite field
ChildTopMargin
Specifies the top margin (in 1000ths of an inch) around each child field within the composite field and between the child field and the top boundary of the composite field
CollapsePolicy
Specifies what happens when an entire row or column in the matrix is empty. Valid options are:
CP_NONE
Specifies that empty rows and columns are allowed and maintained. If you set the Rows and Columns properties, the settings are enforced.
CP_BOTH
Specifies that empty rows and columns are removed automatically, as soon as the last field is removed from the row or column. Setting either the Rows or Columns property has no effect.
CP_ROWS
Specifies that empty rows are removed automatically, as soon as the last field in the row is removed. Setting the Rows property has no effect. However, empty columns are maintained, and you can set the Columns property.
CP_COLUMNS
Specifies that empty columns are removed automatically, as soon as the last field in the column is removed. Setting the Columns property has no effect. However, empty rows are maintained, and you can set the Rows property.
Default: CP_BOTH
Columns
May let you specify the number of columns within the matrix field, depending on the CollapsePolicy property setting
Rows
May let you specify the number of rows within the matrix field, depending on the CollapsePolicy property setting
Note: The number of rows and columns should be consistent with the total number of child fields in the matrix field.