Home > Language Reference > Classes > ChoiceControl

List Property

Caption of an item in a list.

Syntax

Public Property Get List(ByVal iIndex As Integer) As String
Public Property Let List(ByVal iIndex As Integer, ByVal sValue As String)

Remarks

The List property reads or modifies the heading of each item in the list displayed by the control. The index of the first item is zero whilst the last element is ListCount -1. If the iIndex parameter is outside these limits, a runtime error occurs.

When reading, this property can be used to identify the selected item in the list. However, operations on strings being significantly slower than on integers, it is advisable to associate a numeric value to each element and use the ItemData property to identify an item.

When writing, this property can be used to update the heading of an item without having having to rebuild the list. If the value of the Redraw property is True, the display is updated immediately.

System requirements