Back to Devexpress

Token Box Elements

aspnet-16409-components-data-editors-aspxtokenbox-visual-elements.md

latest3.6 KB
Original Source

Token Box Elements

  • Jul 06, 2021
  • 2 minutes to read

This topic describes the visible elements of the ASPxTokenBox.

The following visual elements are available.

You can display a Drop-Down Window when the token box is focused. The window contains items that users can use to add corresponding tokens.

The table below lists the main members that affect element appearance and functionality.

CharacteristicsMembers
VisibilityASPxTokenBox.ShowDropDownOnFocus
Filter ModeASPxAutoCompleteBoxBase.IncrementalFilteringMode
StyleASPxAutoCompleteBoxBase.ListBoxStyle

Input Area

An Input Area allows users to input tokens.

You can use the ASPxTokenBox.TokenBoxInputStyle property to customize Input Area style settings.

If no token is specified and the editor is not focused, the Input Area can display prompt text, which is specified by the ASPxAutoCompleteBoxBase.NullText property. The prompt text disappears when the editor receives focus.

aspx
<dx:ASPxTokenBox ID="MyTokenBox" runat="server" NullText="Select contacts...">
     ...
</dx:ASPxTokenBox>

The image below shows the result.

Item

The ASPxTokenBox control displays Items in the Drop Down Window where users can add corresponding tokens. Users can type text in the Input Area to filter Items.

The table below lists the main members that affect element appearance and functionality.

CharacteristicsMembers
Item CollectionASPxAutoCompleteBoxBase.Items
Filter ModeASPxAutoCompleteBoxBase.IncrementalFilteringMode
StyleASPxAutoCompleteBoxBase.ItemStyle

Token

A Token is a text element in the ASPxTokenBox editor. The Token consists of the Text and Remove Button elements.

The table below lists the main members that affect element appearance and functionality.

CharacteristicsMembers
Token StyleASPxTokenBox.TokenStyle, ASPxTokenBox.TokenHoverStyle
Token Text StyleASPxTokenBox.TokenTextStyle
Token Remove Button StyleASPxTokenBox.TokenRemoveButtonStyle, ASPxTokenBox.TokenRemoveButtonHoverStyle