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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Core, 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 ComboBox does not allow all selected tokens to fit on one line, newly selected tokens will appear on a new line.

To provide easier access to selected items do one of the following.

• Set the TextEditBase.VerticalScrollBarVisibility (via ComboBoxEdit.VerticalScrollBarVisibility) property to Visible or Auto. This way a user will be able to navigate the tokens.
• Set the ComboBoxEdit.Height property to Auto. In this case, the height of a combo box will be 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>