RepositoryItemCheckedComboBoxEdit.SeparatorChar Property

Gets or sets the character that separates checked items in the edit value and the resulting text displayed in the edit box.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v25.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(',')]
[DXCategory("Format")]
public virtual char SeparatorChar { get; set; }

VB.NET

<DXCategory("Format")>
<DefaultValue(","c)>
Public Overridable Property SeparatorChar As Char

Property Value

Type	Default	Description
Char	','	A separator character.

Remarks

Use the SeparatorChar property to separate items in the edit value and the resulting text displayed in the edit box.

You can set a CheckedComboBoxEdit control’s value using the CheckedComboBoxEdit.SetEditValue method. The assigned value must specify a string that concatenates values (strings) of items to be checked. Values in the resulting string must be separated with the separator character specified by the SeparatorChar property, followed by a SPACE character.

Notes

• When the control is bound to a bit field, the SeparatorChar property is not in effect. The current thread’s ListSeparator property specifies a delimiter for flags in the text displayed in the edit box.

• To ensure correct operation, specify a unique separator character that is not a part of an editor item’s display text/value.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SeparatorChar 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#

winforms-checked-combobox-show-tooltips-for-selected-items/CS/WindowsApplication3/Form1.cs#L26

    carsBindingSource.DataSource = GetCarSchedulingDataTable();
    separatorChar = checkedComboBoxEdit1.Properties.SeparatorChar;
}

VB.NET

winforms-checked-combobox-show-tooltips-for-selected-items/VB/WindowsApplication3/Form1.vb#L24

    carsBindingSource.DataSource = GetCarSchedulingDataTable()
    separatorChar = checkedComboBoxEdit1.Properties.SeparatorChar
End Sub