Back to Devexpress

ComboBoxEdit.SelectedIndex Property

windowsforms-devexpress-dot-xtraeditors-dot-comboboxedit-1af98965.md

latest6.1 KB
Original Source

ComboBoxEdit.SelectedIndex Property

Gets or sets the index of the selected ComboBox item. This index specifies the item position inside the RepositoryItemComboBox.Items collection.

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(-1)]
[DXCategory("Appearance")]
public virtual int SelectedIndex { get; set; }
vb
<DXCategory("Appearance")>
<DefaultValue(-1)>
Public Overridable Property SelectedIndex As Integer

Property Value

TypeDefaultDescription
Int32-1

The zero-based index of the edit value in the RepositoryItemComboBox.Items collection; otherwise, -1.

|

Remarks

To get or set the selected ComboBoxEdit item, you can also use the the ComboBoxEdit.SelectedItem property. This property accepts item values instead of their indexes.

If the editor’s edit value refers to an item that does not exist in the RepositoryItemComboBox.Items collection, the SelectedIndex property returns -1.

If you set SelectedIndex to an invalid index (less than zero or bigger than than the last item index), the ComboBoxEdit.SelectedItem property is set to null and the edit box displays an empty string.

Example

The following code illustrates how to automatically select the first ComboBoxEdit item when a user activates a Data Grid cell.

csharp
private void gridView1_ShownEditor(object sender, EventArgs e)
        {
            GridView currentView = sender as GridView;
            ComboBoxEdit cmbPO = currentView.ActiveEditor as ComboBoxEdit;
            //.............
            if (cmbPO.Properties.Items.Count > 0)
            {
                cmbPO.SelectedIndex = 0;   
            }
        }
vb
Dim currentView As GridView = TryCast(sender, GridView)
            Dim cmbPO As ComboBoxEdit = TryCast(currentView.ActiveEditor, ComboBoxEdit)
            '.............
            If cmbPO.Properties.Items.Count > 0 Then
                cmbPO.SelectedIndex = 0
            End If

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectedIndex property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

winforms-charts-use-automatic-date-time-scale-modes-of-an-axis/CS/DateTimeAggregation/Form1.cs#L30

csharp
FillFunctions();
    cbMeasureUnit.SelectedIndex = 1;
}

winforms-spellchecker-enable-in-text-box/CS/Form1.cs#L40

csharp
private void cmbDictionaryType_SelectedIndexChanged(object sender, EventArgs e) {
    switch (cmbDictionaryType.SelectedIndex) {
        case 0:

XPO_how-to-bind-data-to-winforms-controls-using-xpbindingsource/CS/DXApplication/Form1.cs#L16

csharp
SetupLookupDataSources();
    DataSourceTypeComboBox.SelectedIndex = 0;
}

winforms-charts-use-automatic-date-time-scale-modes-of-an-axis/VB/DateTimeAggregation/Form1.vb#L45

vb
FillFunctions()
    cbMeasureUnit.SelectedIndex = 1
End Sub

winforms-spellchecker-enable-in-text-box/VB/Form1.vb#L40

vb
Private Sub cmbDictionaryType_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    Select Case cmbDictionaryType.SelectedIndex
        Case 0

XPO_how-to-bind-data-to-winforms-controls-using-xpbindingsource/VB/DXApplication/Form1.vb#L15

vb
SetupLookupDataSources()
    DataSourceTypeComboBox.SelectedIndex = 0
End Sub

See Also

SelectedItem

Items

EditValue

ComboBoxEdit Class

ComboBoxEdit Members

DevExpress.XtraEditors Namespace