Class RowColumnDefinition
The RowColumnDefinition class describes constraints on a row or a column in a Panel of type Panel.Table. It also provides information about the actual layout after the Table Panel has been arranged.
Constructor Summary Details
| Returns | Name | Description |
|---|---|---|
|
RowColumnDefinition()
|
You do not need to use this constructor, because calls to
Panel.getRowDefinition or Panel.getColumnDefinition
will automatically create and remember a RowColumnDefinition for you.
|
Properties Summary Details
| Returns | Name | Description |
|---|---|---|
{number}
|
actual
|
This read-only property returns the usable row height or column width, after arrangement, in local coordinates,
that objects in this row or column can be placed within. More...
This does not include separatorPadding or separatorStrokeWidth, as total does.
This value gives the row height if isRow is true; otherwise this gives the column width. The value is meaningless until after the Table Panel using this RowColumnDefinition has been arranged. See also: |
{Spot}
|
alignment
|
Gets or sets a default alignment for elements that are in this row or column. More...
The value must be a Spot.
The default value is Spot.Default, so that this RowColumnDefinition
does not supply any alignment information for the row or column.
When an element's GraphObject.alignment property is Spot.Default, it gets the horizontal alignment from the element's column's RowColumnDefinition and the vertical alignment from the element's row's RowColumnDefinition. When that RowColumnDefinition.alignment property is also Default, it takes the value from the table panel's Panel.defaultAlignment property. See also: |
{string|Brush}
|
background
1.2
|
Gets or sets the background color for a particular row or column,
which fills the entire span of the row or column, including any separatorPadding. More...
See also:
|
{boolean}
|
coversSeparators
1.2
|
Determines whether or not the background, if there is one, is in front of or behind the separators. More...
Default is false.
|
{number}
|
height
|
Gets or sets the row height, in local coordinates. More...
This describes the row height if isRow is true;
otherwise this property is meaningless.
The value must be non-negative and finite.
The default value is NaN, which means this row will get a height
that is just big enough to hold all of the objects in the row.
Setting this value to a number will mean that all of the objects
of this Panel in this row will be allocated that
amount of row height.
Whether an object in the row is actually arranged to have that height
depends on whether the GraphObject.alignment stretches vertically.
See also:
|
{number}
|
index
|
|
{boolean}
|
isRow
|
|
{number}
|
maximum
|
Gets or sets the maximum row height or column width, in local coordinates. More...
The maximum describes the row height if isRow is true;
otherwise this describes the column width.
The value must be non-negative.
The default value is Infinity.
The arranged height of all objects in this row,
or the arrange width of all objects in this column,
will be no greater than this value.
See also:
|
{number}
|
minimum
|
Gets or sets the minimum row height or column width, in local coordinates. More...
The minimum describes the row height if isRow is true;
otherwise this describes the column width.
The value must be non-negative and finite.
The default value is zero.
The arranged height of all objects in this row,
or the arrange width of all objects in this column,
will be no less than this value.
See also:
|
{Panel}
|
panel
|
This read-only property returns the Panel that this row or column definition is in.
|
{number}
|
position
|
This read-only property returns the actual arranged row or column starting position, after arrangement, in local coordinates. More...
This value gives the Y position if isRow is true;
otherwise this gives the X position.
The value is meaningless until after the Table Panel using this
RowColumnDefinition has been arranged.
See also:
|
{Array.
|
separatorDashArray
1.2
|
Gets or sets the dash array for dashing the separator line, provided this
row or column has a nonzero RowColumnDefinition.separatorStrokeWidth and non-null RowColumnDefinition.separatorStroke. More...
Must be an array of positive numbers and zeroes, or else null to indicate a solid line. For example, the array [5, 10] would create dashes of 5 pixels and spaces of 10 pixels. Setting an array with all zeroes will set the value to null. Default is null, so that this RowColumnDefinition does not supply any stroke dash array information for what is drawn before the row or column. The separator line may still be drawn using dashes if Panel.defaultRowSeparatorDashArray or Panel.defaultColumnSeparatorDashArray is non-null. See also: |
{?Margin}
|
separatorPadding
1.2
|
Gets or sets the additional padding for a particular row or column, in local coordinates. More...
Padding is applied on two sides - before and after a row or column's contents.
The separatorStrokeWidth comes before any padding.
See also:
|
{string|Brush}
|
separatorStroke
1.2
|
Gets or sets the stroke (color) for a particular row or column,
provided that row or column has a nonzero RowColumnDefinition.separatorStrokeWidth. More...
See also:
|
{number}
|
separatorStrokeWidth
1.2
|
Gets or sets the stroke width for a particular row or column's separator, in local coordinates. More...
See also:
|
{EnumValue}
|
sizing
|
Gets or sets how this row or column deals with a Table Panel's extra space. More...
The value must be one of: RowColumnDefinition.None, RowColumnDefinition.ProportionalExtra,
or RowColumnDefinition.Default.
The default value is RowColumnDefinition.Default.
See also:
|
{EnumValue}
|
stretch
|
Gets or sets the default stretch for elements that are in this row or column. More...
The only accepted values are listed as constant properties of GraphObject:
GraphObject.None, GraphObject.Fill, GraphObject.Horizontal, GraphObject.Vertical, or GraphObject.Default.
When an element's GraphObject.stretch property is GraphObject.Default, it gets the horizontal stretch from the element's column's RowColumnDefinition and the vertical stretch from the element's row's RowColumnDefinition. When that RowColumnDefinition.stretch property is also Default, it takes the value from the table panel's Panel.defaultStretch property. See also: |
{number}
|
total
1.2
|
This read-only property returns the total arranged row height or column width, after arrangement, in local coordinates. More...
This value gives the actual size plus the separatorPadding and separatorStrokeWidth.
The value is meaningless until after the Table Panel using this
RowColumnDefinition has been arranged.
See also:
|
{number}
|
width
|
Gets or sets the column width, in local coordinates. More...
The size describes the column width if isRow is false;
otherwise this property is meaningless.
The value must be non-negative and finite.
The default value is NaN, which means this column will get a width
that is just big enough to hold all of the objects in the column.
Setting this value to a number will mean that all of the objects of this Panel in this column will be allocated that amount of column width. Whether an object in the column is actually arranged to have that width depends on whether the GraphObject.alignment stretches horizontally. See also: |
Method Summary Details
| Returns | Name | Description |
|---|---|---|
|
bind(binding)
|
Constants Summary Details
| Returns | Name | Description |
|---|---|---|
| <constant> {EnumValue} |
Default
|
The default sizing, which resolves to RowColumnDefinition.None or else
the Table Panel's rowSizing and columnSizing if present.
|
| <constant> {EnumValue} |
None
|
The default sizing if none is specified on the Table Panel's rowSizing and columnSizing.
|
| <constant> {EnumValue} |
ProportionalExtra
|
If a Table Panel is larger than all the rows then this sizing
grants this row and any others with the same value the extra space, apportioned proportionally between them
|