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

TokenEdit Class

The text editor that applies custom validation to the entered text and transforms text blocks which passed this validation to tokens.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

public class TokenEdit :
    BaseEdit,
    IPopupControl,
    IPopupControlHookPopupFactory,
    IMouseWheelSupport,
    IDXMenuSupport,
    ITextEditControllerOwner,
    IDirectXClientProviderEx,
    IDirectXClientProvider,
    ISupportsAutoSize

The following members return TokenEdit objects:

#Remarks

The TokenEdit is an advanced text editor that can apply custom validation logic to the entered text and transform those text blocks that have successfully passed this validation into tokens - visual elements that can display glyphs and fire various events in response to user actions (for example, TokenClick, TokenMouseEnter).

Read the following topic for additional information and examples: Token Edit Control.

Tagline Edit - MailDemo

Run Demo

#Examples

#Unbound Mode

In unbound mode, the TokenEdit stores tokens in the Properties.Tokens collection. The following example demonstrates how to add unbound tokens in code:

tokenEdit1.Properties.BeginUpdate();
// Token values must be unique.
tokenEdit1.Properties.Tokens.AddToken("Description string A", "value1");
tokenEdit1.Properties.Tokens.AddToken("Description string B", "value2");
// ... add more tokens
tokenEdit1.Properties.EndUpdate();

#Bound Mode

  1. Use the Properties.DataSource property to bind the TokenEdit control to a data source.
  2. Use the Properties.DisplayMember to specify the data field that stores token descriptions.
  3. Use the Properties.ValueMember to specify the field that stores token values. Token values must be unique.
tokenEdit1.Properties.BeginUpdate();
tokenEdit1.Properties.DataSource = queryBindingSource;
tokenEdit1.Properties.DisplayMember = "EmailAddress";
tokenEdit1.Properties.ValueMember = "EmailAddressID";
tokenEdit1.Properties.EndUpdate();

#Inheritance

See Also