From Xojo Documentation

You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!

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

New in 2021r3

Supported for all project types and targets.

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


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 Opening event:

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

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

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

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