Titanium.UI.TableViewRow

Use the Titanium.UI.createTableViewRow method to create a table view row.

A table view row represents a single item in a TableView. The row's contents can be as simple as a single line of text, or the row can be a completely customized with its own child views.

A basic table view row includes properties for setting:

• Row title--the text displayed on the row.
• Optional images on the left and right sides of the row.
• Optional system decorations, such as checkboxes.

You can also set the usual view properties, such as background color and background image.

If you want a custom layout for your view, such as multiple lines of text, different fonts, or additional images or controls, you can add child views to the row. In this case, you should not specify a title for the row.

Make sure you set the className on each row instance if using more than one type of row layout. You can use the same value for each instance of a row where the layout is the same - even if the value of the elements inside the row have different values. For example, if the text is the only thing different between two cells but the layout is the same, both row instances should have the same value for className.

You can listen for table row events on all rows by adding an event listener to the table view instance. Events automatically propagate to parent views.

Platform Implementation Notes

The top, left and other positional parameters are not used for their usual purposes, because the table view row is automatically positioned by its parent.

On Android, these properties are used to position the content (title) inside the row. For example, setting top to 20 moves the title down from the top of the row. On iOS, these values have no effect.

On Mobile Web, these properties are used to relatively position the row, treating the TableView as if it were a horizontal layout.

Also, note that the selected text color, selectedColor, can only be set on iOS and Mobile Web. On Android, the text color does not change when the row is selected.