Xojo Documentation Xojo Documentation

Method

ListBox.CellCheckBoxStateAt(row as Integer, column as Integer) As VisualStates

New in 2019r2

Supported for all project types and targets.

Used to get or set the state of the cell with the coordinates of row, column (zero-based). This assumes that the passed cell is a CheckBox cell. Use the CellType property to set a cell to a CheckBox cell. CheckBox.VisualStates is an Enum of the CheckBox class.

Example

The CellCheckBoxStateAt method enables you to get or set the value of a tri-state Checkbox cell. Any cell of type TypeCheckbox box can store one of three values: Checked, Unchecked, and Indeterminate.

To set up a cell as TypeCheckbox, use code such as this in the Open event:

Me.CellTypeAt(1, 0) = ListBox.CellTypes.CheckBox

To change the state of the cell, use the VisualStates enum of the CheckBox control:

ListBox1.CellCheckBoxStateAt(1, 0) = Checkbox.VisualStates.Indeterminate

The Indeterminate state places a minus sign in the checkbox (macOS) or filled in checkbox (Windows and Linux).