CheckedTokenComboBoxStyleSettings.EnableTokenWrapping Property

Gets or sets a value that specifies whether token wrapping is enabled. This is a dependency property.

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v25.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public bool? EnableTokenWrapping { get; set; }

VB.NET

Public Property EnableTokenWrapping As Boolean?

Property Value

Type	Description
Nullable<Boolean>	true to enable token wrapping; otherwise, false.

Remarks

If the EnableTokenWrapping property is set to true and the width of a ComboBoxEdit is insufficient to fit all selected tokens on one line, newly selected tokens appear on a new line.

Note

Enabling the EnableTokenWrapping property hides the drop-down button .

If you need to display the dropdown button, set the ButtonEdit.AllowDefaultButton (via ComboBoxEdit.AllowDefaultButton) property to true.

To facilitate access to selected items, do one of the following:

• Set the TextEditBase.VerticalScrollBarVisibility (via ComboBoxEdit.VerticalScrollBarVisibility) property to Visible or Auto to allow users to navigate between tokens.
• Set the ComboBoxEdit.Height property to Auto. In this case, the height of a combo box is adjusted according to the number of tokens.

Related GitHub Examples

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

XAML

reporting-wpf-custom-editor-for-report-parameter/CS/CustomParameterEditorsWPF/MainWindow.xaml#L25

<dxe:ComboBoxEdit.StyleSettings>
    <dxe:CheckedTokenComboBoxStyleSettings AllowEditTokens="False" EnableTokenWrapping="True" ShowTokenButtons="True" NewTokenPosition="Far" />
</dxe:ComboBoxEdit.StyleSettings>