# Row

Represents one row within a grid or table.

### Description

A row element describes one row in a grid or table. A row is composed of a list of cells. Rows can set style properties to affect all cells within the row.

### XML Summary

### See Also

## style

Name of the style applied to this row.

### Description

Rows provide many style properties. The style properties are defined in the ROM Styles Specification. An element can inherit its style properties from a parent element, from a named style, or from a style that identifies the context in which the item appears. This property provides the name of the shared style to use.

This item can also set the value of style properties. Properties set on this element "override" those inherited from a parent element or a shared style.

All properties defined for a style appear as properties on report items also. See the Style element for the list of properties that appear here.

### See Also

Style element in the ROM Styles Specification.

## visibility

A list of rules for hiding and displaying this row in various output formats.

### Description

The visibility rules control when the row appears in the report. A row can be completely hidden, in which case it won’t even be created in the Factory. A row can also be hidden conditionally depending on the output format.

### See Also

Visibility Rule structure for the details of the rules.

## bookmark

A bookmark to use as a target of links within this report.

### Description

Many report items can be the target of hyperlinks. The bookmark is a string that uniquely identifies the item instance within the report. This property is an expression that evaluates to a string. If the string is blank or null, then the item has no bookmark. Bookmarks should be unique. If there are duplicates, the behavior of the hyperlink is undefined: it may jump to the first item with that name.

### See Also

Action property on labels, data items, images and other items.

## eventHandlerClass

The full qulified name of the event handler class.

### Description

Full quilified name of the event handler class, used to specify an external Java class which define the scripting behavior that will be executed at runtime.

## height

Minimum height of the row.

### Description

Minimum height of the row. Some items have a dynamic size. The actual size of row is computed as the minimum of the tallest cell within the row, or the row height.

## onCreate

Script executed when the element is created in the Factory.

### Description

Executed when the element is created in the Factory. Called after the item is created, but before the item is saved to the report document file. See the scripting spec for additional information about this script. Applications should perform visual customization in the on-render script instead.

## onPrepare

It is for a script startup phase. No data binding yet. The design of an element can be changed here.

### Description

It is for a script startup phase. No data binding yet. The design of an element can be changed here.

## onRender

Script executed when the element is prepared for rendering in the Presentation engine.

### Description

Executed when the element is prepared for rendering in the Presentation engine. Changes made to the element are written to the target output format, but not saved to the report document file. This is the preferred place for visual customizations.

### See Also

Dimension property type

## cells

Any number of cell entries for the row.

### Description

Any number of Cell elements for the row.

### See Also