RepositoryItemCheckedComboBoxEdit.SeparatorChar Property

Gets or sets the character separating checked items in the edit value, and the resultant text displayed in the edit box.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v24.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

The SeparatorChar property is used to separate items in the edit value and the resultant text displayed in the edit box.

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

The SeparatorChar property is not in effect when the control is bound to a bit field. When the control is bound to a bit field, flags in the text displayed in the edit box are delimited, using the character specified by the current thread’s ListSeparator property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references 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-with-images/CS/WindowsApplication3/CheckedImageComboBoxEditPainter.cs#L33

RepositoryItemCheckedImageComboBoxEdit edit = viewInfo.Item as RepositoryItemCheckedImageComboBoxEdit;
string[] values = text.Split(edit.SeparatorChar);
Rectangle valRect = new Rectangle(bounds.X, bounds.Y, 0, bounds.Height);

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-with-images/VB/WindowsApplication3/CheckedImageComboBoxEditPainter.vb#L38

Dim edit As RepositoryItemCheckedImageComboBoxEdit = TryCast(viewInfo.Item, RepositoryItemCheckedImageComboBoxEdit)
Dim values() As String = text.Split(edit.SeparatorChar)
Dim valRect As New Rectangle(bounds.X, bounds.Y, 0, bounds.Height)

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

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