Xojo Documentation Xojo Documentation

Combo Box Library Icon

The Combo Box control works like a combination of a Text Field and a Popup Menu. The user can either enter text in the Combo Box or choose an item from the attached Popup Menu. A menu selection can be modified after it is selected. Unlike a real Text Field, you cannot use a mask to filter data entry or operate it as a Password Field.

Combo Box Example

Refer to ComboBox in Reference Guide for details on all its events, properties and methods.

Below is a list of common events, properties and methods.

Events

Change

Called when the selected item in the popup menu has changed.

TextChanged

Called when the value was changed, either by typing or through code (by setting the Value property).

Properties

RowValueAt

This property takes one parameter, an index of the row. It returns the text of the item in the menu specified by the index parameter. If the index does not exist, then an OutOfBoundsException is raised.

RowCount As Integer

An Integer containing the number of rows in the menu.

SelectedRowIndex As Integer

An Integer used to get or set the currently selected row in the menu.

SelectedRowValue As String

Contains the text of the currently selected row.

Methods

AddRow, AddAllRows

Takes as a parameter a string or an array of strings to add a row or rows to the menu.

AddSeparator

Adds a separator line (only on Mac).

RemoveAllRows

Removes all rows from the menu.

AddRowAt

Adds a row at the index position and using the text passed.

RemoveRowAt

Takes as parameters the number of the row to remove.

RowTag

Takes as a parameter the number of the row to which to assign the tag. The tag can be any value or class (variant).

Handling Focus

ComboBoxes on any platform display the focus by highlighting the selected item and showing a blinking insertion point. On Mac, a ComboBox with the focus also has a focus ring. When a ComboBox has the focus, you can scroll through the list of choices with the up and down arrow keys and select an item by pressing the Return key. Of course, you can also edit or replace the selected item.

Usage

You can use an array to populate the ComboBox:

Var names() As String = Array("Fred", "Jane", "Bill", "Betty")
ComboBox1.AddAllRows(names)

See Also

ComboBox class; UserGuide:Desktop Popup Menu topic