Sign in Join
FPDoc Onlineexperiment

TCustomComboBox.SelectItem function

Member of TCustomComboBoxprotectedIn unit StdCtrls

Selects the list item with the specified text.

Declaration

pascal
function SelectItem(const AnItem: string): Boolean

Arguments

AnItem

The text to find in Items.

Function result

True when a matching item was found and selected.

Description

SelectItem is a Boolean function used to select the list item in the control with the value specified in AnItem. The return value is True when the Items property contains an entry with the value in AnItem.

The value in ItemIndex is updated with the ordinal position in Items for the specified value, or -1 when AnItem does not exist in Items. When the value in ItemIndex is changed, the Click and Select methods are called to refresh the control display and to signal the OnClick and OnSelect event handlers.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.