Skip to main content
A newer version of this page is available. .

RepositoryItemTokenEdit Members

Provides access to the TokenEdit control’s settings.

Constructors

Name Description
RepositoryItemTokenEdit() Initializes a new instance of the RepositoryItemTokenEdit class with the default settings.

Fields

Name Description
DefaultDropDownRowCount Stores the default TokenEdit drop-down list capacity, equal to 7 lines.
DefaultEditValueSeparatorChar This member supports the internal infrastructure, and is not intended to be used directly from your code.
DefaultMaxExpandLines Stores the default number of lines (4) a TokenEdit can be expanded to. If a Token Edit needs more than 4 lines to display its content, vertical scroll bar appears. To modify this line count, use the RepositoryItemTokenEdit.MaxExpandLines property.

Properties

Name Description
AccessibleDefaultActionDescription Gets or sets the default action description of the repository item for use by accessibility client applications. Inherited from RepositoryItem.
AccessibleDescription Gets or sets the description of the repository item used by accessibility client applications. Inherited from RepositoryItem.
AccessibleName Gets or sets the repository item’s name which is used by accessibility client applications. Inherited from RepositoryItem.
AccessibleRole Gets or sets the repository item’s accessible role. Inherited from RepositoryItem.
AllowFocused Gets or sets a value specifying whether the focus rectangle is displayed within the editor when it has focus. Inherited from RepositoryItem.
AllowFocusedAppearance Gets a value which indicates whether the appearance settings used to paint the editor when it’s focused can be used. Inherited from RepositoryItem.
AllowHtmlDraw Gets or sets whether HTML tags can be used to format an editor’s text or text of the editor’s items. Inherited from RepositoryItem.
AllowInplaceAutoFilter This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
AllowInplaceBorderPainter This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
AllowMouseWheel Gets or sets whether value scrolling via the Mouse Wheel is supported by the editor. Inherited from RepositoryItem.
Appearance Gets the appearance settings used to paint the editor when it’s enabled. Inherited from RepositoryItem.
AppearanceDisabled Gets the appearance settings used to paint the editor when it’s disabled. Inherited from RepositoryItem.
AppearanceDropDown Provides access to appearance settings that allow you to customize the drop-down list appearances for this TokenEdit.
AppearanceFocused Gets the appearance settings used to paint the current editor when it’s focused. Inherited from RepositoryItem.
AppearanceReadOnly Gets the appearance settings used to paint the read-only editor. Inherited from RepositoryItem.
AutoHeight This member supports the internal infrastructure, and is not intended to be used directly from your code. Use the RepositoryItemTokenEdit.AutoHeightMode instead to set whether the TokenEdit should automatically expand based on its current content.
AutoHeightMode Gets or sets the TokenEdit control’s auto-hide mode.
BestFitWidth Gets or sets the editor’s best fit width. Inherited from RepositoryItem.
BorderStyle Gets or sets the editor’s border style. Inherited from RepositoryItem.
CanRaiseEvents protected Gets a value indicating whether the component can raise an event. Inherited from Component.
CheckedItems Returns the object that contains all currently checked tokens in this TokenEdit.
CheckMode Gets or sets whether only one or multiple tokens can be selected (checked) simultaneously within this TokenEdit control.
ClearCheckStatesOnLostFocus Gets or sets whether checked tokens within the related TokenEdit control should be deselected when the editor loses focus.
Container Gets the IContainer that contains the Component. Inherited from Component.
ContextMenu Gets or sets the context menu for the editor. Inherited from RepositoryItem.
ContextMenuStrip Gets or sets the shortcut menu for the editor. Inherited from RepositoryItem.
CustomDropDownControl Gets or sets the custom drop-down control for this TokenEdit.
DefaultAlignment Gets the default horizontal alignment of the editor’s content. Inherited from RepositoryItem.
DefaultBorderStyleInBars This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
DefaultBorderStyleInGrid This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
DeleteTokenOnGlyphClick Gets or sets whether a TokenEdit‘s token should be deleted if an end-user clicks this token’s image.
DesignMode protected Gets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DisplayFormat Provides access to the format settings applied to the editor’s display text. These settings are in effect when the editor does not have input focus. Inherited from RepositoryItem.
DropDownRowCount Gets or sets the maximum number of drop-down menu items for this TokenEdit.
DropDownShowMode Gets or sets the way this TokenEdit‘s drop-down list is displayed.
Editable Gets whether the editor’s value can be changed. Inherited from RepositoryItem.
EditFormat Provides access to the settings used to format the edit value when the editor has input focus. Inherited from RepositoryItem.
EditMode Gets or sets whether an end-user can manually enter and validate any desired text within this TokenEdit.
EditorTypeName Gets the editor’s textual representation.
EditValueChangedDelay Gets or sets the time interval between the moment when an end-user stops changing the editor’s value and the RepositoryItem.EditValueChanged event being raised. Inherited from RepositoryItem.
EditValueChangedFiringDelay static Gets or sets the default time interval between the moment when an end-user stops changing the editor’s value and the RepositoryItem.EditValueChanged event being raised. Inherited from RepositoryItem.
EditValueChangedFiringMode Gets or sets the RepositoryItem.EditValueChanged event’s firing mode. Inherited from RepositoryItem.
EditValueSeparatorChar Gets or sets the character used to separate the TokenEdit.EditValue property value into multiple text blocks.
EditValueType Gets or sets the type of this TokenEdit‘s edit value.
Enabled Gets or sets a value indicating whether the edit control can respond to user actions. This property is supported for standalone editors. Inherited from RepositoryItem.
Events protected Gets the list of event handlers that are attached to this Component. Inherited from Component.
ExportMode Specifies whether the editor’s value or display text is exported when data is exported to XLS and CSV formats. Inherited from RepositoryItem.
HtmlImages Gets or sets a collection of images that can be embedded in the editor’s display text or the display text of the editor’s items, using the image tag. Inherited from RepositoryItem.
IsDesignMode Indicates whether the editor is currently in design mode. Inherited from RepositoryItem.
IsDisposed Gets a value indicating whether the control has been disposed of. Inherited from RepositoryItem.
IsFilterLookUp This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
IsLoading Indicates whether the editor is being loaded. Inherited from RepositoryItem.
IsLockUpdate Gets a value indicating whether the editor is immediately updated in response to changing its settings. Inherited from RepositoryItem.
IsNonSortableEditor This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
LinkCount Gets the number of objects connected to the current repository item. Inherited from RepositoryItem.
LookAndFeel Provides access to the stand-alone editor’s look and feel settings. These settings are not in effect for the editor in a bar, ribbon, grid, etc. Inherited from RepositoryItem.
MaxExpandLines Gets or sets the maximum number of lines this TokenEdit can occupy. This property is ignored if the editor is used in-place.
MaxTokenCount Gets or sets the maximum tokens number this TokenEdit control can simultaneously display.
MinRowCount Gets or sets the initial number of rows displayed by this TokenEdit.
Name Gets or sets the repository item name. Inherited from RepositoryItem.
NormalizeDisplayText static Set the NormalizeDisplayText property to true to correctly process diacritics when selecting rows from a dropdown window in the LookUpEdit control. Inherited from RepositoryItem.
NullText Gets or sets the text that presents the editor’s null value (null, System.DBNull.Value and RepositoryItemDateEdit.NullDate - for DateEdit). Inherited from RepositoryItem.
OwnerEdit Returns a TokenEdit that owns this RepositoryItemTokenEdit.
OwnerItem This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
PopupFilterMode Gets or sets how items within this TokenEdit‘s popup are filtered.
PopupOffset Gets or sets the popup window’s location. Inherited from RepositoryItem.
PopupPanel Gets or sets the FlyoutPanel assigned to this TokenEdit.
PopupPanelOptions Provides access to the set of properties that specify the peek panel behavior.
PopupSizeable Gets or sets whether this TokenEdit‘s drop-down list should display a size grip.
Properties Obsolete. This member supports the internal infrastructure, and is not intended to be used directly from your code.
ReadOnly Gets or sets a value specifying whether the editor’s value can be changed by end-users. Inherited from RepositoryItem.
RequireDisplayTextSorting This member supports the .NET Framework infrastructure and is not intended to be used directly from your code. Inherited from RepositoryItem.
SelectedItems Gets the collection that contains all tokens currently visible in the TokenEdit.
Separators Provides access to the additional separators collection that are used along with the default separator (the RepositoryItemTokenEdit.EditValueSeparatorChar property) to break the RepositoryItemTokenEdit text into separate blocks that are converted into tokens.
ShowDropDown Gets or sets whether this TokenEdit control’s drop-down list should be displayed.
ShowRemoveTokenButtons Gets or sets whether items within this TokenEdit control’s drop-down list should display the ‘remove’ icon.
ShowSelectedItemsInPopup This member supports the internal infrastructure, and is not intended to be used directly from your code.
ShowSeparators This member supports the internal infrastructure, and is not intended to be used directly from your code.
ShowTokenGlyph Gets or sets whether token glyphs should be displayed.
Site Gets or sets a ISite for the object. Inherited from RepositoryItem.
Tag Gets or sets the data associated with the repository item. Inherited from RepositoryItem.
TokenGlyphLocation Gets or sets the location of token icons relative to token captions.
TokenPopulateMode Gets or sets whether or not the RepositoryItemTokenEdit.Tokens collection supports automatic population.
Tokens Provides access to this TokenEdit control’s token collection.
UseParentBackground This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
UseReadOnlyAppearance Gets or sets whether this Token Edit Control should be painted using the read-only appearance settings.
UseTextEditorForAutoFilter Gets whether to substitute this editor with the single-line text editor in auto-filter rows. Inherited from RepositoryItem.
ValidationRules Gets or sets a set of validation rules for this TokenEdit.

Methods

Name Description
AddEnum(Type, Boolean, Boolean) Populates this RepositoryItemTokenEdit with items generated from values of the specific enumeration.
AddEnum(Type, Boolean) Populates this RepositoryItemTokenEdit with items generated from values of the specific enumeration. Allows generated tokens to store numeric enumeration values instead of enumeration constant names.
AddEnum(Type) Populates this RepositoryItemTokenEdit with items generated from values of the specific enumeration.
AddEnum<TEnum>() Populates this RepositoryItemTokenEdit with items generated from values of the specific enumeration.
AddEnum<TEnum>(Boolean) Populates this RepositoryItemTokenEdit with items generated from values of the specific enumeration. Allows generated items to store numeric enumeration values instead of enumeration constant names.
Assign(RepositoryItem) Copies all settings from the target RepositoryItem to this RepositoryItemTokenEdit object.
BeginInit() Notifies the editor that the initialization has been started. Inherited from RepositoryItem.
BeginUpdate() Locks the RepositoryItem object by disallowing visual updates until the EndUpdate or CancelUpdate method is called. Inherited from RepositoryItem.
CancelUpdate() Unlocks the RepositoryItem object after it has been locked by the BeginUpdate method, without causing an immediate visual update. Inherited from RepositoryItem.
Clone() Creates a copy of the current repository item. Inherited from RepositoryItem.
Connect(Object) Connects the repository item to the specified object. Inherited from RepositoryItem.
CreateEditor() Creates an editor whose type corresponds to the repository item’s type. Inherited from RepositoryItem.
CreateGroupPainter() Initializes a new instance of the DevExpress.XtraEditors.Drawing.BaseEditorGroupRowPainter class. Inherited from RepositoryItem.
CreateObjRef(Type) Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. Inherited from MarshalByRefObject.
CreatePainter() This member supports the editor library’s internal infrastructure and is not intended to be used in your applications. Inherited from RepositoryItem.
CreateViewInfo() This member supports the editors library’s internal infrastructure and is not intended to be used in your applications. Inherited from RepositoryItem.
Disconnect(Object) Removes the connection between the repository item and the specified object. Inherited from RepositoryItem.
Dispose() Releases all resources used by the Component. Inherited from Component.
EndInit() Notifies the editor that the initialization has been completed. Inherited from RepositoryItem.
EndUpdate() Unlocks the RepositoryItem object after a call to the BeginUpdate method and causes an immediate visual update. Inherited from RepositoryItem.
Equals(Object, Object) static Determines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object) Determines whether the specified object is equal to the current object. Inherited from Object.
GetBorderSides(Boolean, Boolean) static This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
GetBrick(PrintCellHelperInfo) Returns a brick object that contains information on how the current editor should be printed.
GetDisplayText(FormatInfo, Object) Returns the text representation of the specified value, formatted according to the specified settings. Inherited from RepositoryItem.
GetDisplayText(Object) Returns the text representation of the specified value formatted using the editor’s settings. Inherited from RepositoryItem.
GetEditorType() This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
GetEditValueForExportByOptions(Object, Object, Object, Object, Function3<String, Object, Object, Object>, ExportTarget) This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
GetHashCode() Returns a hash code. Inherited from RepositoryItem.
GetLifetimeService() Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject.
GetNormalizedText(String) static This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
GetService(Type) protected Returns an object that represents a service provided by the Component or by its Container. Inherited from Component.
GetType() Gets the Type of the current instance. Inherited from Object.
InitializeLifetimeService() Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject.
IsActivateKey(Keys) Indicates whether a particular key can activate the editor used as an inplace control. Inherited from RepositoryItem.
IsLockDefaultImmediateUpdateRowPosition() This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
IsNeededKey(Keys) Indicates whether the key is handled by the editor or the container control. Inherited from RepositoryItem.
LockEvents() This method supports the .NET framework infrastructure and is not intended to be called from your code. Inherited from RepositoryItem.
MemberwiseClone() protected Creates a shallow copy of the current Object. Inherited from Object.
MemberwiseClone(Boolean) protected Creates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject.
ReferenceEquals(Object, Object) static Determines whether the specified Object instances are the same instance. Inherited from Object.
ResetEvents() This member supports the .NET Framework infrastructure and is not intended to be used in your applications. Inherited from RepositoryItem.
ScaleProperties(ScaleHelper) Updates the RepositoryItem according to current scale settings. This method is called automatically when the form’s runtime DPI settings differ from those in design-time. Inherited from RepositoryItem.
SetCloned() This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
ToString() Returns a string that represents the current object. Inherited from RepositoryItem.
UnLockEvents() This method supports the .NET framework infrastructure and is not intended to be called from your code. Inherited from RepositoryItem.
Validate() Validates the text entered in the editor.

Events

Name Description
BeforeShowMenu Fires before this TokenEdit control’s popup menu is shown. Allows you to customize items within this menu.
BeforeShowPopupPanel Occurs before the peek panel assigned to this TokenEdit is displayed.
Click Fires when clicking the editor. Inherited from RepositoryItem.
CustomDisplayText Enables custom display text to be provided for an editor. Inherited from RepositoryItem.
CustomDrawTokenBackground Occurs each time a token needs to be displayed and allows you to manually draw its background.
CustomDrawTokenGlyph Allows you to re-draw the default token glyph.
CustomDrawTokenText Allows you to re-paint the token text area.
Disposed Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DoubleClick Fires when the editor is double clicked. Inherited from RepositoryItem.
DragDrop Fires when an object is dropped onto the editor. Inherited from RepositoryItem.
DragEnter Fires when a dragged object enters the editor’s area. Inherited from RepositoryItem.
DragLeave Fires when a dragged object leaves the editor’s area. Inherited from RepositoryItem.
DragOver Fires repeatedly when dragging an object over the editor. Inherited from RepositoryItem.
EditValueChanged Fires when the editor’s BaseEdit.EditValue property changes. Inherited from RepositoryItem.
EditValueChanging Fires when the editor’s value is about to be changed. Inherited from RepositoryItem.
Enter Fires when the editor receives focus. Inherited from RepositoryItem.
FormatEditValue Enables you to format the editor’s value (change the editor’s value when the formatting mechanism is invoked). Inherited from RepositoryItem.
GiveFeedback Enables you to specify the cursor appearance when dragging this editor’s data. Inherited from RepositoryItem.
HelpRequested Fires when the end-user requests help for the editor. Inherited from RepositoryItem.
KeyDown Fires when a key is pressed while the editor has focus. Inherited from RepositoryItem.
KeyPress Fires when a character key is pressed while the editor has focus. Inherited from RepositoryItem.
KeyUp Fires when a key is released while the editor has focus. Inherited from RepositoryItem.
Leave Fires when the editor loses focus. Inherited from RepositoryItem.
Modified Fires when the edit value is first changed since it was last validated. Inherited from RepositoryItem.
MouseDown Fires when a mouse button is pressed while the mouse pointer is over the editor. Inherited from RepositoryItem.
MouseEnter Fires when the mouse pointer enters the editor’s area. Inherited from RepositoryItem.
MouseHover Fires when hot-tracking an editor element. Inherited from RepositoryItem.
MouseLeave Fires when the mouse pointer leaves the editor’s area. Inherited from RepositoryItem.
MouseMove Fires when the mouse pointer moves over the editor’s area. Inherited from RepositoryItem.
MouseUp Fires when the mouse button is released while the mouse pointer is over the editor. Inherited from RepositoryItem.
MouseWheel Fires when the mouse wheel moves while the mouse pointer is within the editor. Inherited from RepositoryItem.
ParseEditValue Converts an input value (entered by a user or assigned in code) to the value that the editor will store. Inherited from RepositoryItem.
PropertiesChanged Fires immediately after a change to one of the editor’s properties. Inherited from RepositoryItem.
QueryAccessibilityHelp Fires when the help is provided to accessibility applications. Inherited from RepositoryItem.
QueryContinueDrag Fires when dragging the editor’s data allowing you to specify whether dragging should be continued. Inherited from RepositoryItem.
QueryProcessKey Provides the capability to specify whether the key pressed in the editor is processed by the editor or a container control (GridControl, TreeList, etc.) that displays this editor. Inherited from RepositoryItem.
SelectedItemsChanged Occurs whenever a token is added or removed to (from) the TokenEdit.
TokenAdded Occurs after a new token was successfully added to this TokenEdit.
TokenAdding Occurs when a new token is about to be added to this TokenEdit.
TokenCheckStateChanged Occurs when an end-user checks or unchecks a token within the corresponding TokenEdit.
TokenClick Fires whenever an end-user clicks a token displayed within this TokenEdit control.
TokenDoubleClick Occurs when an end-user double clicks a token within this TokenEdit.
TokenMouseEnter Fires whenever a user focuses a token.
TokenMouseHover Occurs when an end-user hovers a token within this TokenEdit.
TokenMouseLeave Fires when a TokenEdit token loses mouse focus.
TokenRemoved Occurs after a token is removed from this TokenEdit.
TokenRemoving Fires when a token is about to be removed from this TokenEdit.
ValidateToken Allows you to perform the custom validation on text currently entered in this TokenEdit control.
Validating Allows you to specify whether the edit value is valid. This event does not occur if the editor’s CausesValidation property is disabled. Inherited from RepositoryItem.
See Also