You see the Properties window for a Table Row Group component when you select it under a Table component in the Navigator window. A Table Row Group component is part of a table component, so you might have to expand a table's node in the Navigator window to see the Table Row Group components under it.
You can use the Table Layout dialog box to set many of these properties. Not only is that dialog box easier to use in some respects than individual Properties windows for the Table, Table Column, and Table Row Group components, but you can work more naturally with the table and all its columns there. To open the dialog box, right-click the table in the Visual Designer and choose Table Layout.
General
id. Type: String
The name of the Table Row Group component in the page bean and the JSP file.
Appearance
aboveColumnFooter.Type: boolean
If selected, the row group footer is displayed above the column footers. The default is
to display the row group footer below the column footers.
aboveColumnHeader.Type: boolean
If selected, the row group header is displayed above the column headers. The default is to
display the row group header below the column headers.
align.Type: String
Specifies the horizontal alignment for the cell. Possible values are left, center, right, and justify.
collapsed.Type: boolean
If selected, the table row group shows only the header and not the rows, footer, or column text. This property is not selected by default, and
the table row group is expanded, with all rows in the group visible.
footerText.Type: String
The text displayed for the row group footer, providing an overall footer for the data group represented by this row group.
groupToggleButton.Type: boolean
If selected, displays a button that the user can click to expand or contract the row group.
headerText.Type: String
The text displayed for the row group header, providing an overall header for the data group represented by this row group.
selected. Type: boolean
If this property is selected, the appearance of the current row changes to indicate that it is selected. Typically you bind this property to a JavaBeans property that returns a value based on the request scope attribute set in the sourceVar property.
selectMultipleToggleButton. Type: boolean
If selected, adds a button that enables a user to select all rows displayed in the table at once. This button is used to toggle a column of checkboxes by using the ID given to the selectId property of the Table Column Component.
styleClasses. Type: String
A space-separated list of CSS2 style classes to be applied when the component is rendered. The style classes must be defined in the project's style sheet or in the theme's CSS file. If you click the ellipsis button (...), you see a list of all styles you can add to this property. For information on adding CSS classes and rules to the project's cascading style sheet, see CSS Editor.
This property overrides any settings in the theme or the project CSS file for this component. If a class specified in this property does not appear to take effect, it is because an area of the component is obscured by a child component that has different style settings.
If you add a CSS style class from the current theme to your project CSS file and you redefine the style class, the change affects all components that use this style class. However, you can add your own style classes to the project CSS file that redefine the default style classes, and then when you add them to this property, the changes affect only this instance of this component.
valign. Type: String
Specifies the vertical position within the cell of the cell contents. Possible values are:
top - Positions the contents at the top of the cell.
middle - The default value, which centers the contents vertically.
bottom - Positions the contents at the bottom of the cell.
baseline - Specifies that the first line of each cell uses a common baseline.
Layout
multipleColumnFooters. Type: boolean
If selected, multiple column footers are shown. If Table Column components are nested, footers are rendered inverted to column headers. The default value, not selected, shows one level only.
multipleTableColumnFooters. Type: boolean
If selected, multiple table column footers are shown. If Table Column components are nested, footers are rendered inverted to column headers. The default value, not selected, shows one level only.
Data
rows.Type: int
The number of rows to be displayed for a paginated table. The default value is
25 rows per page. See the paginateButton property description in Table Properties Window for more information on paginated tables.
sourceData.Type: TableDataProvider
The database table for this component. This value must be of type TableDataProvider. Because this property is referenced during the decode,
validate, update and renderer phases when iterating over rows, the
object bound to this property should be cached so that the object
is not created more often than needed. When a Table Row Group is created, a default data provider is set for this property.
If you drop a database table on the Table Row Group, this property is set for you. You can also click the ellipsis button (...) to the right of the property and choose a data provider from a list. There is a TableDataProvider for every database table that you have added to the page.
sourceVar.Type: TableDataProvider
Name of the request-scope attribute under which model data for the current row
is exposed when iterating through the data. During iterative processing over the rows of
data in the data provider, the TableDataProvider for the current row is exposed
as a request attribute under the key specified by this property. This
value must be unique for each table in the page.
Behavior
first.Type: int
The zero-relative row number of the first row to be displayed for a paginated
table. See the paginateButton property description in Table Properties Window for more information on paginated tables.
toolTip. Type: String
The value of the title attribute for the column. The specified text will display as a tooltip if the mouse cursor hovers over a cell in the column.
If the component is disabled, the tooltip will not display in most browsers.
visible. Type: boolean
Indicates whether or not the component can be seen by the user on the rendered HTML page. This property is selected by default, making the Row Group visible by default. If you deselect this property, the rows of the Table Row Group are rendered to HTML but are hidden, although any header, footer, or column text remains visible. Since it is rendered, but hidden, the Table Row Group can be made visible again through a client side action.
JavaScript
onClick. Type: String
JavaScript to be executed when the user clicks the component.
onDblClick. Type: String
JavaScript to be executed when the user double-clicks the component.
onKeyDown. Type: String
JavaScript to be executed when the component has focus and a key is pressed.
onKeyPress. Type: String
JavaScript to be executed when the component has focus and a key is pressed and released.
onKeyUp. Type: String
JavaScript to be executed when the component has focus and a key is released.
onMouseDown. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user presses down on the mouse button.
onMouseMove. Type: String
JavaScript to be executed when the user moves the mouse cursor within the component.
onMouseOut. Type: String
JavaScript to be executed when the user moves the mouse cursor away from the component after it has been over the component.
onMouseOver. Type: String
JavaScript to be executed when the user moves the mouse cursor onto the component.
onMouseUp. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user releases the mouse button.
Advanced
emptyDataMessage. Type: String
The message displayed on a single table row when the table does not contain
data. This row, which consists of one cell that spans all columns, is blank
except for the text provided by this property.
extraFooterHtml. Type: String
Extra HTML code to be appended to the <tr> HTML element that is rendered for the row group footer. Use only code that is valid in an HTML <td> element. The code you specify is inserted in the HTML element and is not checked for validity. For example, you might set this attribute to nowrap='nowrap'.
extraHeaderHtml. Type: String
Extra HTML code to be appended to the <tr> HTML element that is rendered for the row group header. Use only code that is valid in an HTML <td> element. The code you specify is inserted in the HTML element and is not checked for validity. For example, you might set this attribute to nowrap='nowrap'.
rendered. Type: boolean
If selected, the component is to be rendered and processed on any subsequent page submission. If not selected, the Table Row Group shows nothing on the page, including the rows and any associated
header, footer, or column text for the group, and none of the information is in the
HTML. not even as hidden components. If this property is not selected (false), it overrides the rendered properties of any child components.
You can bind this property to a JavaBeans property that determines when the component does get rendered. For example, an airline reservation form might show a Table Row Group for frequent flyers and not show it for the general public. To bind this property, click the ellipsis button (...) to the right of the property and choose Use Binding in the dialog box.