RepositoryItemPopupGalleryEdit.SeparatorChar Property
Gets or sets the delimiter used to separate items selected in the PopupGalleryEdit editor. This delimiter separates item values in the editor’s value and item captions in the editor’s edit box.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(',')]
[DXCategory("Format")]
public virtual char SeparatorChar { get; set; }
Property Value
Type | Default | Description |
---|---|---|
Char | ',' | The delimiter used to separate items selected in the PopupGalleryEdit editor. |
Remarks
The PopupGalleryEdit editor allows multiple gallery items to be selected simultaneously. To specify the selection mode, use the BaseGallery.ItemCheckMode property of the PopupGalleryEditGallery object accessed using the RepositoryItemPopupGalleryEdit.Gallery property. Note that, to be selectable, a gallery item should have the GalleryItem.Value property specified.
If the RepositoryItemPopupGalleryEdit.EditValueType property is set to CSV, the PopupGalleryEdit editor’s value (see BaseEdit.EditValue) is represented by the plain text composed of selected item values (see GalleryItem.Value) separated with the delimiter specified by the SeparatorChar property, followed by a space character. Also, the PopupGalleryEdit editor’s edit box displays the selected item captions (see GalleryItem.Caption) separated with this delimiter. The default delimiter is a comma. You can use the SeparatorChar property override this setting.
To provide custom text displayed in the edit box, you can handle the RepositoryItemPopupGalleryEdit.QueryDisplayText event.