TokenizingTextBox Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
A text input control that auto-suggests and displays token items.
[Windows.UI.Xaml.TemplatePart(Name="Normal", Type=typeof(Windows.UI.Xaml.VisualState))]
[Windows.UI.Xaml.TemplatePart(Name="PointerOver", Type=typeof(Windows.UI.Xaml.VisualState))]
[Windows.UI.Xaml.TemplatePart(Name="Focused", Type=typeof(Windows.UI.Xaml.VisualState))]
[Windows.UI.Xaml.TemplatePart(Name="Unfocused", Type=typeof(Windows.UI.Xaml.VisualState))]
public class TokenizingTextBox : Windows.UI.Xaml.Controls.ListViewBase
[<Windows.UI.Xaml.TemplatePart(Name="Normal", Type=typeof(Windows.UI.Xaml.VisualState))>]
[<Windows.UI.Xaml.TemplatePart(Name="PointerOver", Type=typeof(Windows.UI.Xaml.VisualState))>]
[<Windows.UI.Xaml.TemplatePart(Name="Focused", Type=typeof(Windows.UI.Xaml.VisualState))>]
[<Windows.UI.Xaml.TemplatePart(Name="Unfocused", Type=typeof(Windows.UI.Xaml.VisualState))>]
type TokenizingTextBox = class
inherit ListViewBase
Public Class TokenizingTextBox
Inherits ListViewBase
- Inheritance
-
Windows.UI.Xaml.Controls.ListViewBaseTokenizingTextBox
- Derived
- Attributes
-
Windows.UI.Xaml.TemplatePartAttribute
Constructors
TokenizingTextBox() |
Initializes a new instance of the TokenizingTextBox class. |
Fields
Properties
AutoSuggestBoxStyle |
Gets or sets the Style for the contained AutoSuggestBox template part. |
AutoSuggestBoxTextBoxStyle |
Gets or sets the Style for the TextBox part of the AutoSuggestBox template part. |
MaximumTokens |
Gets or sets the maximum number of token results allowed at a time. |
PlaceholderText |
Gets or sets the PlaceholderText for the AutoSuggestBox template part. |
QueryIcon |
Gets or sets the icon to display in the AutoSuggestBox template part. |
SelectedTokenText |
Gets the complete text value of any selection in the control. The result is the same text as would be copied to the clipboard. |
SuggestedItemContainerStyle |
Gets or sets the item container style for displaying suggested tokens. |
SuggestedItemsSource |
Gets or sets the items source for token suggestions. |
SuggestedItemTemplate |
Gets or sets the template for displaying suggested tokens. |
SuggestedItemTemplateSelector |
Gets or sets the template selector for displaying suggested tokens. |
TabNavigateBackOnArrow |
Gets or sets a value indicating whether the control will move focus to the previous control when an arrow key is pressed and selection is at one of the limits in the control. |
Text |
Gets or sets the input text of the currently active text edit. |
TextMemberPath |
Gets or sets the TextMemberPath of the AutoSuggestBox template part. |
TokenDelimiter |
Gets or sets delimiter used to determine when to process text input as a new token item. |
TokenItemTemplate |
Gets or sets the template for token items. |
TokenItemTemplateSelector |
Gets or sets the template selector for token items. |
TokenSpacing |
Gets or sets the spacing value used to separate token items. |
Methods
AddTokenItem(Object, Boolean) |
Adds the specified data item as a new token to the collection, will raise the TokenItemAdding event asynchronously still for confirmation. |
ClearAsync() |
Clears the whole collection, will raise the TokenItemRemoving event asynchronously for each item. |
GetContainerForItemOverride() | Windows.UI.Xaml.Controls.ListViewBase.GetContainerForItemOverride |
IsItemItsOwnContainerOverride(Object) | Windows.UI.Xaml.Controls.ListViewBase.IsItemItsOwnContainerOverride(System.Object) |
OnApplyTemplate() | Windows.UI.Xaml.Controls.ListViewBase.OnApplyTemplate |
OnCreateAutomationPeer() |
Creates AutomationPeer (Windows.UI.Xaml.UIElement.OnCreateAutomationPeer) |
PrepareContainerForItemOverride(DependencyObject, Object) | Windows.UI.Xaml.Controls.ListViewBase.PrepareContainerForItemOverride(Windows.UI.Xaml.DependencyObject,System.Object) |
UpdateCurrentTextEdit(ITokenStringContainer) |
Helper to change out the currently focused text element in the control. |
Events
QuerySubmitted |
Event raised when the user submits the text query. |
SuggestionChosen |
Event raised when a suggested item is chosen by the user. |
TextChanged |
Event raised when the text input value has changed. |
TokenItemAdded |
Event raised when a new token item has been added. |
TokenItemAdding |
Event raised before a new token item is created from a string, can be used to transform data type from text user entered. |
TokenItemRemoved |
Event raised after a token has been removed. |
TokenItemRemoving |
Event raised when a token item is about to be removed. Can be canceled to prevent removal of a token. |