ComboBoxEdit.SelectedItem Property

Specifies the editor’s value.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

[Browsable(false)]
public virtual object SelectedItem { get; set; }

VB.NET

<Browsable(False)>
Public Overridable Property SelectedItem As Object

Property Value

Type	Description
Object	The editor’s value.

Remarks

When you select an item from the dropdown, a corresponding object from the item collection is automatically assigned to SelectedItem. In addition, entering a value in the edit box changes the SelectedItem.

The SelectedItem property matches the value of the ComboBoxEdit.EditValue property. The difference between them is that you can set ComboBoxEdit.EditValue to any object, while SelectedItem can be set only to an element of the RepositoryItemComboBox.Items collection.

The ComboBoxEdit.SelectedIndex property returns the index of the SelectedItem value in the RepositoryItemComboBox.Items collection. This allows you to know whether the current editor’s value is from the dropdown list or arbitrary data.

Note: to ensure proper functionality of the editor, items in the RepositoryItemComboBox.Items collection must be unique objects.

The code sample below illustrates how to use a combo box to specify the data source for a grid.

C#

xmlDataSet = new System.Data.DataSet("XML DataSet");
xmlDataSet.ReadXml(@".\\transportation.xml");
comboBoxEdit1.Properties.Items.AddRange(new string[] { "Drivers", "Vehicles", "Products" });

private void comboBoxEdit1_SelectedIndexChanged(object sender, EventArgs e)
{
    var combo = sender as ComboBoxEdit;
    gridControl1.DataSource = xmlDataSet.Tables[combo.SelectedItem.ToString()];

}

VB.NET

xmlDataSet = New System.Data.DataSet("XML DataSet")
xmlDataSet.ReadXml(".\\transportation.xml")
comboBoxEdit1.Properties.Items.AddRange(New String() { "Drivers", "Vehicles", "Products" })

private void comboBoxEdit1_SelectedIndexChanged(Object sender, EventArgs e)
    Dim combo = TryCast(sender, ComboBoxEdit)
    gridControl1.DataSource = xmlDataSet.Tables(combo.SelectedItem.ToString())

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectedItem 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.

C#

how-to-customize-the-chart-designer-t462899/CS/ChartDesignerCustomization/CustomLegendOptionsControl.cs#L36

updateStarted = true;
cbeHorizontalAlignment.SelectedItem = LegendModel.AlignmentHorizontal;
cbeVerticalAlignment.SelectedItem = LegendModel.AlignmentVertical;

winforms-map-calculate-routes-from-major-roads/CS/CalculateRoutesFromMajorRoads/Form1.cs#L64

private void OnTravelModeSelectedIndexChanged(object sender, EventArgs e) {
    routeProvider.RouteOptions.Mode = (BingTravelMode)cbeTravelMode.SelectedItem;
}

import-from-html-how-to-specify-encoding-and-external-content-location-e1756/CS/BeforeImportExample/Form1.cs#L43

void LoadSampleText() {
    if(cmbEncodings.SelectedItem == null)
        cur_Encoding = Encoding.Unicode;

how-to-create-a-comboboxedit-control-with-mru-capabilities-e2551/CS/WindowsFormsApplication18/MRUComboBoxEdit.cs#L19

    base.OnPopupClosed(closeMode);
    Properties.StoreRecentItem(this.SelectedItem);
}

how-to-link-a-propertygridcontrol-with-a-combo-box-that-contains-a-list-of-editable-objects-e505/CS/Form1.cs#L20

ComboBoxEdit comboBox = (ComboBoxEdit)sender;
CmbItem item = (CmbItem)comboBox.SelectedItem;
if(item == null)

VB.NET

how-to-customize-the-chart-designer-t462899/VB/ChartDesignerCustomization/CustomLegendOptionsControl.vb#L45

updateStarted = True
cbeHorizontalAlignment.SelectedItem = LegendModel.AlignmentHorizontal
cbeVerticalAlignment.SelectedItem = LegendModel.AlignmentVertical

winforms-map-calculate-routes-from-major-roads/VB/CalculateRoutesFromMajorRoads/Form1.vb#L70

Private Sub OnTravelModeSelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    routeProvider.RouteOptions.Mode = CType(cbeTravelMode.SelectedItem, BingTravelMode)
End Sub

import-from-html-how-to-specify-encoding-and-external-content-location-e1756/VB/BeforeImportExample/Form1.vb#L45

Private Sub LoadSampleText()
    If cmbEncodings.SelectedItem Is Nothing Then
        cur_Encoding = Encoding.Unicode

how-to-create-a-comboboxedit-control-with-mru-capabilities-e2551/VB/WindowsFormsApplication18/MRUComboBoxEdit.vb#L16

    MyBase.OnPopupClosed(closeMode)
    Properties.StoreRecentItem(Me.SelectedItem)
End Sub

how-to-link-a-propertygridcontrol-with-a-combo-box-that-contains-a-list-of-editable-objects-e505/VB/Form1.vb#L22

Dim comboBox As ComboBoxEdit = CType(sender, ComboBoxEdit)
Dim item As CmbItem = CType(comboBox.SelectedItem, CmbItem)
If item Is Nothing Then