Back to Devexpress

RepositoryItemTokenEdit Members

windowsforms-devexpress-dot-xtraeditors-dot-repository-dot-repositoryitemtokenedit-dot-underscore-members.md

latest56.3 KB
Original Source

RepositoryItemTokenEdit Members

Provides access to the TokenEdit control’s settings.

Constructors

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

Fields

NameDescription
DefaultDropDownRowCountStores the default TokenEdit drop-down list capacity, equal to 7 lines.
DefaultEditValueSeparatorCharThis member supports the internal infrastructure, and is not intended to be used directly from your code.
DefaultMaxExpandLinesStores 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

NameDescription
AccessibleDefaultActionDescriptionGets or sets the default action description of the repository item for use by accessibility client applications. Inherited from RepositoryItem.
AccessibleDescriptionGets or sets the object’s description used by accessibility client applications. Inherited from RepositoryItem.
AccessibleNameGets or sets the object’s name used by accessibility client applications. Inherited from RepositoryItem.
AccessibleRoleGets or sets the object’s accessible role. Inherited from RepositoryItem.
AdvancedModeOptionsGets Advanced Mode options.
AllowFocusedGets or sets a value specifying whether the focus rectangle is displayed within the editor when it has focus. Inherited from RepositoryItem.
AllowFocusedAppearanceGets a value which indicates whether the appearance settings used to paint the editor when it’s focused can be used. Inherited from RepositoryItem.
AllowHtmlDrawGets or sets whether HTML tags can be used to format an editor’s text or text of the editor’s items. Inherited from RepositoryItem.
AllowInplaceAutoFilterThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
AllowInplaceBorderPainterThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
AllowMouseWheelGets or sets whether value scrolling via the Mouse Wheel is supported by the editor. Inherited from RepositoryItem.
AppearanceGets appearance settings used to paint the editor when it is enabled. Inherited from RepositoryItem.
AppearanceDisabledGets appearance settings used to paint the editor when it is disabled. Inherited from RepositoryItem.
AppearanceDropDownProvides access to appearance settings that allow you to customize the drop-down list appearances for this TokenEdit.
AppearanceFocusedGets appearance settings used to paint the current editor when it is focused. Inherited from RepositoryItem.
AppearanceReadOnlyGets appearance settings used to paint the read-only editor. Inherited from RepositoryItem.
AutoHeightThis 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.
AutoHeightModeSpecifies how the TokenEdit adjusts its height to fit its content.
BestFitWidthGets or sets the editor’s best fit width. Inherited from RepositoryItem.
BorderStyleGets or sets the editor’s border style. Inherited from RepositoryItem.
CanRaiseEvents protectedGets a value indicating whether the component can raise an event. Inherited from Component.
CheckModeGets or sets whether only one or multiple tokens can be selected (checked) simultaneously within this TokenEdit control.
ClearCheckStatesOnLostFocusGets or sets whether checked tokens within the related TokenEdit control should be deselected when the editor loses focus.
ContainerGets the IContainer that contains the Component. Inherited from Component.
ContextMenuGets or sets the context menu for the editor. Inherited from RepositoryItem.
CustomDropDownControlGets or sets the custom drop-down control for this TokenEdit.
DataSourceGets or sets an object that stores Tokens.
DefaultAlignmentGets the default horizontal alignment of the editor’s content. Inherited from RepositoryItem.
DefaultBorderStyleInBarsThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
DefaultBorderStyleInGridThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
DeleteTokenOnGlyphClickGets or sets whether a TokenEdit‘s token should be deleted if an end-user clicks this token’s image.
DesignMode protectedGets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DisplayFormatGets format settings applied to the editor’s value. Inherited from RepositoryItem.
DisplayMemberIf the Token Edit is connected to a data source, this property specifies which data source field stores visible Token captions.
DropDownRowCountGets or sets the maximum number of drop-down menu items for this TokenEdit.
DropDownShowModeGets or sets the way this TokenEdit‘s drop-down list is displayed.
EditableGets whether the editor’s value can be changed. Inherited from RepositoryItem.
EditFormatProvides access to the settings used to format the edit value when the editor has input focus. Inherited from RepositoryItem.
EditModeGets or sets whether an end-user can manually enter and validate any desired text within this TokenEdit.
EditorTypeNameGets the editor’s textual representation.
EditValueChangedDelayGets 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 staticGets 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.
EditValueChangedFiringModeGets or sets the RepositoryItem.EditValueChanged event’s firing mode. Inherited from RepositoryItem.
EditValueSeparatorCharGets or sets the character used to separate the TokenEdit.EditValue property value into multiple text blocks.
EditValueTypeGets or sets the type of this TokenEdit‘s edit value.
EnabledGets 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 protectedGets the list of event handlers that are attached to this Component. Inherited from Component.
ExportModeSpecifies whether the editor’s value or display text is exported when data is exported to XLS and CSV formats. Inherited from RepositoryItem.
HtmlImagesGets 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.
InplaceModeImmediatePostChangesFor internal use. Gets or sets whether the in-place editor posts its value to the bound data source immediately after the value changes. Inherited from RepositoryItem.
IsDesignModeIndicates whether the editor is currently in design mode. Inherited from RepositoryItem.
IsDisposedGets a value indicating whether the control has been disposed of. Inherited from RepositoryItem.
IsEditValueChangedEventPendingGets whether the EditValueChanged event is postponed. Inherited from RepositoryItem.
IsFilterLookUpThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
IsLoadingIndicates whether the editor is being loaded. Inherited from RepositoryItem.
IsLockUpdateGets a value indicating whether the editor is immediately updated in response to changing its settings. Inherited from RepositoryItem.
IsNonSortableEditorThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
LinkCountGets the number of objects connected to the current repository item. Inherited from RepositoryItem.
LookAndFeelProvides 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.
MaxExpandLinesGets or sets the maximum number of lines this TokenEdit can occupy. This property is ignored if the editor is used in-place.
MaxTokenCountGets or sets the maximum tokens number this TokenEdit control can simultaneously display.
MinRowCountGets or sets the initial number of rows displayed by this TokenEdit.
NameGets or sets the repository item name. Inherited from RepositoryItem.
NormalizeDisplayText staticSet the NormalizeDisplayText property to true to correctly process diacritics when selecting rows from a dropdown window in the LookUpEdit control. Inherited from RepositoryItem.
NullTextGets or sets the text that presents the editor’s null value ( null , System.DBNull.Value and RepositoryItemDateEdit.NullDate - for DateEdit). Inherited from RepositoryItem.
OwnerEditReturns a TokenEdit that owns this RepositoryItemTokenEdit.
OwnerItemThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
PopupFilterModeGets or sets how items within this TokenEdit‘s popup are filtered.
PopupOffsetGets or sets the popup window’s location. Inherited from RepositoryItem.
PopupPanelGets or sets the FlyoutPanel assigned to this TokenEdit.
PopupPanelOptionsProvides access to the set of properties that specify the peek panel behavior.
PopupSizeableGets or sets whether this TokenEdit‘s drop-down list should display a size grip.
PropertiesObsolete. This member supports the internal infrastructure, and is not intended to be used directly from your code.
ReadOnlyGets or sets a value specifying whether the editor’s value can be changed by end-users. Inherited from RepositoryItem.
RequireDisplayTextSortingThis member supports the .NET Framework infrastructure and is not intended to be used directly from your code. Inherited from RepositoryItem.
SeparatorsProvides 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.
ShowDropDownGets or sets whether this TokenEdit control’s drop-down list should be displayed.
ShowDropDownOnClickGets or sets whether the drop-down window is shown when the user clicks within the edit box.
ShowRemoveTokenButtonsGets or sets whether items within this TokenEdit control’s drop-down list should display the ‘remove’ icon.
ShowSelectedItemsInPopupThis member supports the internal infrastructure, and is not intended to be used directly from your code.
ShowSeparatorsThis member supports the internal infrastructure, and is not intended to be used directly from your code.
ShowTokenGlyphGets or sets whether token glyphs should be displayed.
SiteGets or sets a ISite for the object. Inherited from RepositoryItem.
TagGets or sets the data associated with the repository item. Inherited from RepositoryItem.
TokenGlyphLocationGets or sets the location of token icons relative to token captions.
TokenPopulateModeGets or sets whether or not the RepositoryItemTokenEdit.Tokens collection supports automatic population.
TokensGets a collection of tokens.
UseAdvancedModeGets or sets whether Advanced Mode is enabled. This mode supports new caret and selection animations.
UseParentBackgroundThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
UseReadOnlyAppearanceGets or sets whether this Token Edit Control should be painted using the read-only appearance settings.
UseTextEditorForAutoFilterGets whether to substitute this editor with the single-line text editor in auto-filter rows. Inherited from RepositoryItem.
ValidationRulesGets or sets a set of validation rules for this TokenEdit.
ValueMemberIf the Token Edit is connected to a data source, this property specifies which data source field stores unique Token values.

Methods

NameDescription
AddEnum(Type, Boolean, Boolean)Populates the editor with tokens created based on values of an enumeration.
AddEnum(Type, Boolean)Populates the editor with tokens created based on values of an enumeration. Allows the created tokens to store the enumeration’s underlying integer constants instead of named constants.
AddEnum(Type)Populates the editor with tokens created based on values of an enumeration.
AddEnum<TEnum>()Populates the editor with tokens created based on values of an enumeration.
AddEnum<TEnum>(Boolean)Populates the editor with tokens created based on values of an enumeration. Allows the created tokens to store the enumeration’s underlying integer constants instead of named constants.
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) staticDetermines 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.
ForceInitialize()Forces the control to finish its initialization.
GetBorderSides(Boolean, Boolean) staticThis 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.
GetDisplayValueByKeyValue(Object)
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.
GetKeyValueByDisplayValue(Object)
GetLifetimeService()Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject.
GetNormalizedText(String) staticThis member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
GetService(Type) protectedReturns 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() protectedCreates a shallow copy of the current Object. Inherited from Object.
MemberwiseClone(Boolean) protectedCreates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject.
ReferenceEquals(Object, Object) staticDetermines 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.
SwitchMode()For internal use. 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

NameDescription
BeforePopupFires before the drop-down window is shown.
BeforeShowMenuFires before this TokenEdit control’s popup menu is shown. Allows you to customize items within this menu.
BeforeShowPopupPanelOccurs before the peek panel assigned to this TokenEdit is displayed.
ClickFires when clicking the editor. Inherited from RepositoryItem.
ClosedFires after the drop-down window is closed and gets the reason for closure.
CloseUpFires when the drop-down window is about to be closed and allows you to get and update the selected token.
CustomDisplayTextEnables custom display text to be provided for an editor. Inherited from RepositoryItem.
CustomDrawTokenBackgroundOccurs each time a token needs to be displayed and allows you to manually draw its background.
CustomDrawTokenGlyphAllows you to re-draw the default token glyph.
CustomDrawTokenTextAllows you to re-paint the token text area.
DisposedOccurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DoubleClickFires when the editor is double clicked. Inherited from RepositoryItem.
DragDropFires when an object is dropped onto the editor. Inherited from RepositoryItem.
DragEnterFires when a dragged object enters the editor’s area. Inherited from RepositoryItem.
DragLeaveFires when a dragged object leaves the editor’s area. Inherited from RepositoryItem.
DragOverFires repeatedly when dragging an object over the editor. Inherited from RepositoryItem.
EditValueChangedFires when the editor’s EditValue property changes. Inherited from RepositoryItem.
EditValueChangingFires when the editor’s value is about to be changed. Inherited from RepositoryItem.
EnterFires when the editor receives focus. Inherited from RepositoryItem.
FormatEditValueEnables you to format the editor’s value (change the editor’s value when the formatting mechanism is invoked). Inherited from RepositoryItem.
GiveFeedbackEnables you to specify the cursor appearance when dragging this editor’s data. Inherited from RepositoryItem.
HelpRequestedFires when the end-user requests help for the editor. Inherited from RepositoryItem.
KeyDownFires when a key is pressed while the editor has focus. Inherited from RepositoryItem.
KeyPressFires when a character key is pressed while the editor has focus. Inherited from RepositoryItem.
KeyUpFires when a key is released while the editor has focus. Inherited from RepositoryItem.
LeaveFires when the editor loses focus. Inherited from RepositoryItem.
ModifiedFires when the edit value is first changed since it was last validated. Inherited from RepositoryItem.
MouseDownFires when a mouse button is pressed while the mouse pointer is over the editor. Inherited from RepositoryItem.
MouseEnterFires when the mouse pointer enters the editor’s area. Inherited from RepositoryItem.
MouseHoverFires when hot-tracking an editor element. Inherited from RepositoryItem.
MouseLeaveFires when the mouse pointer leaves the editor’s area. Inherited from RepositoryItem.
MouseMoveFires when the mouse pointer moves over the editor’s area. Inherited from RepositoryItem.
MouseUpFires when the mouse button is released while the mouse pointer is over the editor. Inherited from RepositoryItem.
MouseWheelFires when the mouse wheel moves while the mouse pointer is within the editor. Inherited from RepositoryItem.
ParseEditValueConverts an input value (entered by a user or assigned in code) to the value that the editor will store. Inherited from RepositoryItem.
PopupFires after the drop-down window is opened.
ProcessNewValueFires when a user enters a new value into a Token Edit that is connected to a data source. Allows you to validate entered values and call data source API to save valid records.
PropertiesChangedFires immediately after a change to one of the editor’s properties. Inherited from RepositoryItem.
QueryAccessibilityHelpFires when the help is provided to accessibility applications. Inherited from RepositoryItem.
QueryCloseUpFires before the drop-down window is closed and allows you to cancel the action.
QueryContinueDragFires when dragging the editor’s data allowing you to specify whether dragging should be continued. Inherited from RepositoryItem.
QueryPopUpFires before the drop-down window is opened and allows you to cancel the action.
QueryProcessKeyProvides 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.
RemoveTokenButtonClickOccurs when a user clicks the Remove button in the TokenEdit drop-down menu.
SelectedItemsChangedOccurs whenever a token is added or removed to (from) the TokenEdit.
TokenAddedOccurs after a new token was successfully added to this TokenEdit.
TokenAddingOccurs when a new token is about to be added to this TokenEdit.
TokenCheckStateChangedOccurs when an end-user checks or unchecks a token within the corresponding TokenEdit.
TokenClickFires when a user clicks a token.
TokenDoubleClickOccurs when an end-user double clicks a token within this TokenEdit.
TokenMouseEnterFires whenever a user focuses a token.
TokenMouseHoverOccurs when an end-user hovers a token within this TokenEdit.
TokenMouseLeaveFires when a TokenEdit token loses mouse focus.
TokenRemovedOccurs after a token is removed from this TokenEdit.
TokenRemovingFires when a token is about to be removed from this TokenEdit.
ValidateTokenAllows you to manually validate text entered by the user.
ValidatingAllows 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

RepositoryItemTokenEdit Class

DevExpress.XtraEditors.Repository Namespace