Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.2.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.

See Also