RowData and RowHeadData
Definition
The RowData provides the layout data for a UI element in a container (to which a row layout is assigned). The layout data is valid for the entire row. You can specify a new line in a RowLayout with RowHeadData.
Description of UI Element Properties of RowHeadData
● hAlign
Specifies the horizontal alignment of the UI element in the row layout cell. The default value of this property is beginOfLine. Property hAlign is represented by enumeration type WDCellHAlign and can take the following values:
beginOfLine |
The text is always displayed at the beginning of line. Therefore, the text for value ltr of property textDirection is left-justified. The text for value rtl is right-justified. |
center |
Centered alignment. |
char |
Specifies the alignment using a specific character. Assigning value char allows you to align the cell contents to a single character. |
endOfLine |
The text is always displayed at the end of the line. Therefore, the text for value ltr of property textDirection is right-justified. The text for value rtl is left-justified. |
forcedLeft |
The text is always left-justified, regardless of whether the value is ltr or rtl for property textDirection. |
forcedRight |
The text content is always right-justified, regardless of whether the value is ltr or rtl for the textDirection property. |
justify |
Justified - This value allows forced justification within a row layout cell. |
left |
Left-justified alignment. This value is deprecated. Use beginOfLine instead. |
right |
Right-justified alignment. This value is deprecated. Use forcedRight instead. |
● rowDesign
Specifies the design (padding) of a row, meaning that the row has a right edge. This prevents you from creating gaps between the elements of a row. The default value of this property is rPad . Property rowDesign can take the following values and is represented by enumeration type WDLayoutCellDesign .
Value |
Appearance |
Description |
lPad |
|
Specifies the distance to the top edge (2 pixels), the bottom edge (2 pixels), and the left edge (4 pixels). |
lrNoPad |
|
Specifies the distance to the top edge (2 pixels) and the bottom edge (2 pixels). |
lrPad |
|
Specifies the distance to the top edge (2 pixels), the bottom edge (2 pixels), the left edge (4 pixels), and the right edge (4 pixels). |
Padless |
|
There is no distance between the row and the edges. |
rPad |
|
Specifies the distance to the top edge (2 pixels), the bottom edge (2 pixels), and the right edge (4 pixels) and thus prevents cell contents from touching. |
● rowBackgroundDesign
Specifies the design of the row background. The default value of this property is transparent. You can use the background colors fill1, fill2, and fill3 to highlight semantically different rows. Property rowBackgroundDesign can take the following values and is represented by enumeration type WDCellBackgroundDesign.
Value |
Description |
border |
This is the color of the cell borders. This value is used for nested row layouts to create grid net lines. |
fill1 |
The color corresponds to value primarycolor of property design in the Group UI element. *) |
fill2 |
The color corresponds to value secondarycolor of property design in the Group UI element. *) |
fill3 |
This color corresponds to the color value of the third level of a Tree UI element. *) |
header |
The color is identical with the color of the header area of a Tree UI element or a table. |
plain |
White background. |
transparent |
The background is transparent. The individual cells are displayed without grid net lines. |
*) The colors to be displayed depend on the design topic and the documentation refers to the SAP Standard Design 2002.
● vGutter
Specifies an
additional distance to the left edge. The default value of this property is
none. Other
values are only appropriate if the row layout is used in a matrix layout.
Property vGutter can have the
following values and is represented by enumeration type WDLayoutCellSeparator .
large |
|
Additional horizontal distance of 31 pixels
|
largeWidthRule |
|
Additional horizontal distance of 31 pixels with a vertical line
|
medium |
|
Additional horizontal distance of 17 pixels
|
mediumWithRule |
|
Additional horizontal distance of 17 pixels with a vertical line |
none |
|
No additional distance
|
xLarge |
|
Additional horizontal distance of 63 pixels |
xLargeWithRule |
|
Additional horizontal distance of 63 pixels with a vertical line |
Properties Overview
Name |
Interface |
Type |
Initial Value |
Bindable |
hAlign |
IWDRowHeadData |
WDCellHAlign |
beginOfLine |
not_bindable |
rowDesign |
IWDRowHeadData |
rPad |
not_bindable |
|
rowBackgroundDesign |
IWDRowHeadData |
transparent |
not_bindable |
|
vGutter |
IWDRowHeadData |
WDLayoutCellSeparator |
none |
not_bindable |