Class

# DesktopTableRow

<div class="rst-class">

forsearch

</div>

Table Row

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

A lightweight, read-only accessor for one row of a `DesktopTable</api/user_interface/desktop/desktoptable>`.

An instance is handed out by `DesktopTable.RowAt<desktoptable.rowat>` or by iterating `DesktopTable.Rows<desktoptable.rows>`. It holds no state of its own, only a weak reference to its table, so it stays valid as long as the table does and reports whatever the table currently holds for that row index.

To change a value, use the matching setter on the table itself, for example `DesktopTable.CellTextAt<desktoptable.celltextat>`.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                       | Type                               | Read-Only | Shared |
|--------------------------------------------|------------------------------------|-----------|--------|
| `ColumnCount<desktoptablerow.columncount>` | `Integer</api/data_types/integer>` | ✓         |        |
| `Selected<desktoptablerow.selected>`       | `Boolean</api/data_types/boolean>` | ✓         |        |
| `Tag<desktoptablerow.tag>`                 | `Variant</api/data_types/variant>` | ✓         |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                                           | Parameters                                   | Returns                                                      | Shared |
|--------------------------------------------------------------------------------|----------------------------------------------|--------------------------------------------------------------|--------|
| `CellAlignmentAt<desktoptablerow.cellalignmentat>`                             | column As `Integer</api/data_types/integer>` | `DesktopTable.Alignments<desktoptable.alignments>`           |        |
| `CellAlignmentOffsetAt<desktoptablerow.cellalignmentoffsetat>`                 | column As `Integer</api/data_types/integer>` | `Integer</api/data_types/integer>`                           |        |
| `CellBoldAt<desktoptablerow.cellboldat>`                                       | column As `Integer</api/data_types/integer>` | `Boolean</api/data_types/boolean>`                           |        |
| `CellBorderColorAt<desktoptablerow.cellbordercolorat>`                         | column As `Integer</api/data_types/integer>` | `ColorGroup</api/graphics/colorgroup>`                       |        |
| `CellCheckBoxEnabledAt<desktoptablerow.cellcheckboxenabledat>`                 | column As `Integer</api/data_types/integer>` | `Boolean</api/data_types/boolean>`                           |        |
| `CellCheckBoxStateAt<desktoptablerow.cellcheckboxstateat>`                     | column As `Integer</api/data_types/integer>` | `DesktopCheckBox.VisualStates<desktopcheckbox.visualstates>` |        |
| `CellCheckBoxValueAt<desktoptablerow.cellcheckboxvalueat>`                     | column As `Integer</api/data_types/integer>` | `Boolean</api/data_types/boolean>`                           |        |
| `CellItalicAt<desktoptablerow.cellitalicat>`                                   | column As `Integer</api/data_types/integer>` | `Boolean</api/data_types/boolean>`                           |        |
| `CellProgressBarMaximumValueAt<desktoptablerow.cellprogressbarmaximumvalueat>` | column As `Integer</api/data_types/integer>` | `Double</api/data_types/double>`                             |        |
| `CellProgressBarValueAt<desktoptablerow.cellprogressbarvalueat>`               | column As `Integer</api/data_types/integer>` | `Double</api/data_types/double>`                             |        |
| `CellTagAt<desktoptablerow.celltagat>`                                         | column As `Integer</api/data_types/integer>` | `Variant</api/data_types/variant>`                           |        |
| `CellTextAt<desktoptablerow.celltextat>`                                       | column As `Integer</api/data_types/integer>` | `String</api/data_types/string>`                             |        |
| `CellTooltipAt<desktoptablerow.celltooltipat>`                                 | column As `Integer</api/data_types/integer>` | `String</api/data_types/string>`                             |        |
| `CellTypeAt<desktoptablerow.celltypeat>`                                       | column As `Integer</api/data_types/integer>` | `DesktopTable.CellTypes<desktoptable.celltypes>`             |        |
| `CellUnderlineAt<desktoptablerow.cellunderlineat>`                             | column As `Integer</api/data_types/integer>` | `Boolean</api/data_types/boolean>`                           |        |

## Property descriptions

<div id="desktoptablerow.columncount">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.ColumnCount

**ColumnCount** As `Integer</api/data_types/integer>`

> Number of columns of a row. It is the column count of the table, so every row reports the same number.
>
> This property is read-only.
>
> This example reads the number of columns of a row:
>
> ``` xojo
> Var value As Integer = Table1.RowAt(0).ColumnCount
> ```

<div id="desktoptablerow.selected">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.Selected

**Selected** As `Boolean</api/data_types/boolean>`

> Selection state of a row. Use `DesktopTable.RowSelectedAt<desktoptable.rowselectedat>` to change it.
>
> This property is read-only.
>
> This example reads the selection state of a row:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).Selected
> ```

<div id="desktoptablerow.tag">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.Tag

**Tag** As `Variant</api/data_types/variant>`

> Companion value of a row. Tag of a row. It is the value `DesktopTable.RowTagAt<desktoptable.rowtagat>` sets.
>
> This property is read-only.
>
> This example reads the companion value of a row:
>
> ``` xojo
> Var value As Variant = Table1.RowAt(0).Tag
> ```

## Method descriptions

<div id="desktoptablerow.cellalignmentat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellAlignmentAt

**CellAlignmentAt**(column As `Integer</api/data_types/integer>`) As `DesktopTable.Alignments<desktoptable.alignments>`

> Text alignment of a cell in the specified *column*.
>
> This example reads the text alignment of a cell in the specified column:
>
> ``` xojo
> Var value As DesktopTable.Alignments = Table1.RowAt(0).CellAlignmentAt(1)
> ```

<div id="desktoptablerow.cellalignmentoffsetat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellAlignmentOffsetAt

**CellAlignmentOffsetAt**(column As `Integer</api/data_types/integer>`) As `Integer</api/data_types/integer>`

> Alignment offset (points) of a cell in the specified *column*.
>
> This example reads the alignment offset (points) of a cell in the specified column:
>
> ``` xojo
> Var value As Integer = Table1.RowAt(0).CellAlignmentOffsetAt(1)
> ```

<div id="desktoptablerow.cellboldat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellBoldAt

**CellBoldAt**(column As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Whether a cell in the specified *column* is drawn bold.
>
> This example reads whether a cell in the specified column is drawn bold:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).CellBoldAt(1)
> ```

<div id="desktoptablerow.cellbordercolorat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellBorderColorAt

**CellBorderColorAt**(column As `Integer</api/data_types/integer>`) As `ColorGroup</api/graphics/colorgroup>`

> Border colour, `Nil</api/language/nil>` for none.
>
> This example reads the border colour, Nil for none:
>
> ``` xojo
> Var value As ColorGroup = Table1.RowAt(0).CellBorderColorAt(1)
> ```

<div id="desktoptablerow.cellcheckboxenabledat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellCheckBoxEnabledAt

**CellCheckBoxEnabledAt**(column As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Whether a checkbox cell in the specified *column* is enabled.
>
> This example reads whether a checkbox cell in the specified column is enabled:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).CellCheckBoxEnabledAt(1)
> ```

<div id="desktoptablerow.cellcheckboxstateat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellCheckBoxStateAt

**CellCheckBoxStateAt**(column As `Integer</api/data_types/integer>`) As `DesktopCheckBox.VisualStates<desktopcheckbox.visualstates>`

> State of a checkbox cell in the specified *column*.
>
> This example reads the state of a checkbox cell in the specified column:
>
> ``` xojo
> Var value As DesktopCheckBox.VisualStates = Table1.RowAt(0).CellCheckBoxStateAt(1)
> ```

<div id="desktoptablerow.cellcheckboxvalueat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellCheckBoxValueAt

**CellCheckBoxValueAt**(column As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Value of a checkbox cell in the specified *column*.
>
> This example reads the value of a checkbox cell in the specified column:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).CellCheckBoxValueAt(1)
> ```

<div id="desktoptablerow.cellitalicat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellItalicAt

**CellItalicAt**(column As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Whether a cell in the specified *column* is drawn italic.
>
> This example reads whether a cell in the specified column is drawn italic:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).CellItalicAt(1)
> ```

<div id="desktoptablerow.cellprogressbarmaximumvalueat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellProgressBarMaximumValueAt

**CellProgressBarMaximumValueAt**(column As `Integer</api/data_types/integer>`) As `Double</api/data_types/double>`

> Upper bound of a progress bar cell in the specified *column*.
>
> This example reads the upper bound of a progress bar cell in the specified column:
>
> ``` xojo
> Var value As Double = Table1.RowAt(0).CellProgressBarMaximumValueAt(1)
> ```

<div id="desktoptablerow.cellprogressbarvalueat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellProgressBarValueAt

**CellProgressBarValueAt**(column As `Integer</api/data_types/integer>`) As `Double</api/data_types/double>`

> Value of a progress bar cell in the specified *column*.
>
> This example reads the value of a progress bar cell in the specified column:
>
> ``` xojo
> Var value As Double = Table1.RowAt(0).CellProgressBarValueAt(1)
> ```

<div id="desktoptablerow.celltagat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellTagAt

**CellTagAt**(column As `Integer</api/data_types/integer>`) As `Variant</api/data_types/variant>`

> Tag of a cell in the specified *column*.
>
> This example reads the tag of a cell in the specified column:
>
> ``` xojo
> Var value As Variant = Table1.RowAt(0).CellTagAt(1)
> ```

<div id="desktoptablerow.celltextat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellTextAt

**CellTextAt**(column As `Integer</api/data_types/integer>`) As `String</api/data_types/string>`

> Text of a cell in the specified *column*.
>
> This example reads the text of a cell in the specified column:
>
> ``` xojo
> Var value As String = Table1.RowAt(0).CellTextAt(1)
> ```

<div id="desktoptablerow.celltooltipat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellTooltipAt

**CellTooltipAt**(column As `Integer</api/data_types/integer>`) As `String</api/data_types/string>`

> Tooltip of a cell in the specified *column*.
>
> This example reads the tooltip of a cell in the specified column:
>
> ``` xojo
> Var value As String = Table1.RowAt(0).CellTooltipAt(1)
> ```

<div id="desktoptablerow.celltypeat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellTypeAt

**CellTypeAt**(column As `Integer</api/data_types/integer>`) As `DesktopTable.CellTypes<desktoptable.celltypes>`

> Type of a cell in the specified *column*.
>
> This example reads the type of a cell in the specified column:
>
> ``` xojo
> Var value As DesktopTable.CellTypes = Table1.RowAt(0).CellTypeAt(1)
> ```

<div id="desktoptablerow.cellunderlineat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopTableRow.CellUnderlineAt

**CellUnderlineAt**(column As `Integer</api/data_types/integer>`) As `Boolean</api/data_types/boolean>`

> Whether a cell in the specified *column* is drawn underlined.
>
> This example reads whether a cell in the specified column is drawn underlined:
>
> ``` xojo
> Var value As Boolean = Table1.RowAt(0).CellUnderlineAt(1)
> ```

## Compatibility

|                       |         |
|-----------------------|---------|
| **Project Types**     | Desktop |
| **Operating Systems** | All     |

<div class="seealso">

`DesktopTable</api/user_interface/desktop/desktoptable>`

</div>
