Class

MobileTableCellData

Description

A cell within an iOSTable.

Properties

Name	Type	Read-Only
AccessoryType	AccessoryTypes
BackgroundColor	ColorGroup
Control	MobileUIControl	✓
DetailText	String
DetailTextColor	ColorGroup
Handle	Ptr	✓
Image	Picture
Tag	Variant
Text	String
TextColor	ColorGroup

Enumerations

MobileTableCellData.AccessoryTypes

AccessoryTypes

Additional UI controls for a cell.

Enum

Description

None

A standard plain cell. This is the default for cells.

Disclosure

Use this when selecting a cell results in the display of another a MobileScreen with another table reflecting the next level in the data model hierarchy. This does not track touches, so it does not call the iOSMobileTable.AccessoryPressed event handler. Looks similar to a right arrow or "greater than" symbol.

Checkmark

Use this when a touch on a row results in the selection of that item. This kind of table view is known as a selection list, and it is analogous to a pop-up list. Selection lists can limit selections to one row, or they can allow multiple rows with checkmarks. This does not track touches, so it does not call the iOSMobileTable.AccessoryPressed event handler. Looks like a checkmark.

Info

Use this when you wish to display an info icon on the right side of the row. This tracks touches and touching it calls the iOSMobileTable.AccessoryPressed event handler.

InfoAndDisclosure

Use this when selecting a cell results in the display of a detail MobileScreen of that item (which may or may not be a table view). This tracks touches and touching it calls the iOSMobileTable.AccessoryPressed event handler. Looks like an "i" within a circle.

Property descriptions

MobileTableCellData.AccessoryType

AccessoryType As AccessoryTypes

The accessory type that is displayed in the cell.

Create a new cell with a checkmark accessory:
Var cell As MobileTableCellData = Table1.CreateCell

cell.Text = "Sample"
cell.AccessoryType = MobileTableCellData.AccessoryTypes.Checkmark

Table1.AddRow(0, cell)

MobileTableCellData.BackgroundColor

BackgroundColor As ColorGroup

The background color for the MobileTableCellData.

This code sets the value of the BackgroundColor property:
Me.BackgroundColor = Color.Yellow

MobileTableCellData.Control

Control As MobileUIControl

The custom control in use by this cell, if it was created by iOSTable.CreateCustomCell.

This property is read-only.

MobileTableCellData.DetailText

DetailText As String

The the smaller text that appears below the primary, character-based value of the cell.

Set the detail text:
Var cell As MobileTableCellData = Table1.CreateCell

cell.Text = "Acme Widget"
cell.DetailText = "Price: $3.00"

Table1.AddRow(0, cell)

MobileTableCellData.DetailTextColor

DetailTextColor As ColorGroup

The text color for the detail text of the MobileTableCellData.

MobileTableCellData.Handle

Handle As Ptr

The underlying iOS UITableViewCell.

This property is read-only.

This is only available for cells created with iOSTable.CreateCell or iOSTable.CreateCustomCell.

Important

This is supported for iOS only.

MobileTableCellData.Image

Image As Picture

The image for the cell.

Set the cell image:

Var cell As MobileTableCellData = Table1.CreateCell

cell.Text = "Acme Widget"
cell.Image = widgetImage

Table1.AddRow(0, cell)

MobileTableCellData.Tag

Tag As Variant

A value of any type associated with the cell.

Add a cell tag:

Var cell As MobileTableCellData = Table1.CreateCell

cell.Text = "Acme Widget"
cell.Tag = "123" ' part ID

Table1.AddRow(0, cell)

MobileTableCellData.Text

Text As String

The text of the cell. This is the main (large) text that appears for the row.

Set the text:
Var cell As MobileTableCellData = Table1.CreateCell

cell.Text = "Acme Widget"

Table1.AddRow(0, cell)

MobileTableCellData.TextColor

TextColor As ColorGroup

The text color of the MobileTableCellData.

Notes

You cannot directly create an MobileTableCellData object using its constructor. Instead use the iOSMobileTable.CreateCell or iOSMobileTable.CreateCustomCell methods.

Compatibility

Project Types	Mobile
Operating Systems	iOS