ImageComboBoxEdit.EditValue Property

Gets or sets the editor’s value.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.2.dll

Declaration

C#

[Browsable(false)]
public override object EditValue { get; set; }

VB.NET

<Browsable(False)>
Public Overrides Property EditValue As Object

Property Value

Type	Description
Object	The object representing the edit value.

Remarks

The EditValue property matches the value of the selected item.

When you select a specific item from the dropdown, a corresponding ImageComboBoxItem object from the RepositoryItemImageComboBox.Items collection is assigned to the ImageComboBoxEdit.SelectedItem property and the value of the selected item is assigned to EditValue. See the ComboBoxItem.Value property to specify the item’s value.

When you set the EditValue via code, the control looks through the collection for an item with the same value. If found, the selected item can be retrieved via the ImageComboBoxEdit.SelectedItem property and its index specified by ComboBoxEdit.SelectedIndex. If such an item is not found, reading the ImageComboBoxEdit.SelectedItem property returns null and ComboBoxEdit.SelectedIndex specifies -1.

You can also set EditValue to an ImageComboBoxItem class object. In this instance, if the item belongs to the editor’s collection, EditValue is actually set to the item’s value. Otherwise, EditValue is set to the object being assigned.

Note: To ensure proper functionality of the ImageComboBoxEdit control, item values must be unique within the item collection.

Related GitHub Examples

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

printing-appointment-details-using-the-xtrareports-suite-e1183/CS/PrintingViaReports/Form1.cs#L161

{
    cbView.EditValue = schedulerControl1.ActiveViewType;
    rgrpGrouping.EditValue = schedulerControl1.GroupType;

scheduler-control-use-the-custom-draw-appointment-custom-draw-appointment-background-events/CS/CustomDrawDemo/Form1.cs#L100

private void UpdateControls() {
    cbView.EditValue = schedulerControl1.ActiveViewType;
    rgrpGrouping.EditValue = schedulerControl1.GroupType;

how-to-show-the-filter-panel-on-top-t323677/CS/WindowsApplication3/Main.cs#L13

imageComboBoxEdit.Properties.Items.AddEnum(typeof(FilterPanelLocation));
imageComboBoxEdit.EditValue = FilterPanelLocation.Top;

how-to-implement-the-checkstyle-feature-for-checkedcomboboxedit-e4041/CS/CustomEdit/Form1.cs#L41

    ImageComboBoxEdit edit = sender as ImageComboBoxEdit;
    riCustomEdit.CheckStyle = (CheckStyles)edit.EditValue;
}

how-to-manage-appointments-custom-fields-via-the-context-menu-e5159/CS/DXApplication5/CustomAppointmentForm.cs#L70

    if (AvailablePriorities.Count > 0 && priorityIndex < AvailablePriorities.Count)
        icbPriority.EditValue = icbPriority.Properties.Items[priorityIndex].Value;
}

VB.NET

printing-appointment-details-using-the-xtrareports-suite-e1183/VB/PrintingViaReports/Form1.vb#L146

Private Sub UpdateControls()
    cbView.EditValue = schedulerControl1.ActiveViewType
    rgrpGrouping.EditValue = schedulerControl1.GroupType

scheduler-control-use-the-custom-draw-appointment-custom-draw-appointment-background-events/VB/CustomDrawDemo/Form1.vb#L99

Private Sub UpdateControls()
    cbView.EditValue = schedulerControl1.ActiveViewType
    rgrpGrouping.EditValue = schedulerControl1.GroupType

how-to-show-the-filter-panel-on-top-t323677/VB/WindowsApplication3/Main.vb#L15

imageComboBoxEdit.Properties.Items.AddEnum(GetType(FilterPanelLocation))
imageComboBoxEdit.EditValue = FilterPanelLocation.Top

how-to-implement-the-checkstyle-feature-for-checkedcomboboxedit-e4041/VB/CustomEdit/Form1.vb#L38

    Dim edit As ImageComboBoxEdit = TryCast(sender, ImageComboBoxEdit)
    riCustomEdit.CheckStyle = CType(edit.EditValue, CheckStyles)
End Sub

how-to-manage-appointments-custom-fields-via-the-context-menu-e5159/VB/DXApplication5/CustomAppointmentForm.vb#L63

If AvailablePriorities.Count > 0 AndAlso priorityIndex < AvailablePriorities.Count Then
    icbPriority.EditValue = icbPriority.Properties.Items(priorityIndex).Value
End If