Skip to main content

RepositoryItemLookUpEdit Properties

Contains settings specific to a lookup editor.
Name Description
AcceptEditorTextAsNewValue Gets or sets whether a custom value (a value that is not present in the lookup data source) that is entered in the edit box is accepted by the editor (when the value is validated and editor loses focus). This property supports ComboBox mode for the lookup editor.
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 object’s description used by accessibility client applications. Inherited from RepositoryItem.
AccessibleName Gets or sets the object’s name used by accessibility client applications. Inherited from RepositoryItem.
AccessibleRole Gets or sets the object’s accessible role. Inherited from RepositoryItem.
ActionButtonIndex Gets or sets a value specifying which editor button will open the editor’s dropdown window. Inherited from RepositoryItemPopupBase.
AdvancedModeOptions Inherited from RepositoryItemTextEdit.
AllowButtonNavigation Gets or sets whether to allow users to focus ButtonEdit buttons with the keyboard. Inherited from RepositoryItemButtonEdit.
AllowContextImageChangeAnimation Gets or sets whether the context image is changed using animation. This property is not in effect for in-place editors. Inherited from RepositoryItemTextEdit.
AllowDropDownWhenReadOnly Gets or sets whether an editor’s dropdown can be displayed when the editor is in the read-only state. Inherited from RepositoryItemPopupBase.
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.
AllowGlyphSkinning Gets or sets whether this TextEdit can colorize its icons. Inherited from RepositoryItemTextEdit.
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 RepositoryItemTextEdit.
AllowNullInput Gets or sets whether end users can reset the editor’s value to null with the keyboard. Inherited from RepositoryItemTextEdit.
AllowUpdatePopupWidth Gets whether it is allowed to update popup width.
Appearance Gets appearance settings used to paint the editor when it is enabled. Inherited from RepositoryItem.
AppearanceDisabled Gets appearance settings used to paint the editor when it is disabled. Inherited from RepositoryItem.
AppearanceDropDown Gets appearance settings used to paint the editor’s popup window. Inherited from RepositoryItemPopupBase.
AppearanceDropDownHeader Gets the header panel’s appearance settings.
AppearanceFocused Gets appearance settings used to paint the current editor when it is focused. Inherited from RepositoryItem.
AppearanceReadOnly Gets appearance settings used to paint the read-only editor. Inherited from RepositoryItem.
AutoHeight Gets or sets a value specifying whether the editor’s height is calculated automatically to fit the editor’s content. Inherited from RepositoryItem.
AutoSearchColumnIndex Gets or sets the visible column index against which an incremental search is performed in SearchMode.AutoComplete and SearchMode.OnlyInPopup modes.
BeepOnError Gets or sets whether the masked editor should play a system error sound when a user enters an invalid character (for example, a literal in an editor with a Numeric mask). This property replaces the BeepOnError property in v20.2 and newer. Inherited from RepositoryItemTextEdit.
BestFitMode Gets or sets the “best-fit” mode for columns in the dropdown window. Inherited from RepositoryItemLookUpEditBase.
BestFitRowCount Specifies the maximum number or rows that are processed when invoking the “best-fit” functionality.
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.
Buttons Returns the collection of buttons in the current button editor. Inherited from RepositoryItemButtonEdit.
ButtonsBorderStyle Obsolete. This member is not supported. Inherited from RepositoryItemButtonEdit.
ButtonsStyle Gets or sets the style used to draw editor buttons. Inherited from RepositoryItemButtonEdit.
CanRaiseEvents protected Gets a value indicating whether the component can raise an event. Inherited from Component.
CascadingMember Gets or sets the name(s) of the foreign key field(s) by which the popup data source of the lookup editor is filtered. The field must be editable and accept new values (read-only fields are not supported). Inherited from RepositoryItemLookUpEditBase.
CaseSensitiveSearch Gets or sets whether the end-user needs to type text matching the case when performing an incremental search.
CharacterCasing Gets or sets the character casing applied to the editor’s content. Inherited from RepositoryItemTextEdit.
CheckBoxSelectorMember Gets or sets the name of the data source field that specifies whether the item is selected.
CloseUpKey Gets or sets the key combination used to open and close the pop-up window. Inherited from RepositoryItemPopupBase.
Columns Provides access to the collection of columns displayed in the dropdown window.
Container Gets the IContainer that contains the Component. Inherited from Component.
ContextButtonOptions Provides access to the settings applied to the context buttons displayed by editor items. Inherited from RepositoryItemPopupBase.
ContextButtons Provides access to the collection of context buttons displayed by editor items. Inherited from RepositoryItemPopupBase.
ContextImage Gets or sets a custom image displayed at the editor’s edge, specified by the RepositoryItemTextEdit.ContextImageAlignment property. Inherited from RepositoryItemTextEdit.
ContextImageAlignment Gets or sets the alignment of an image displayed by this editor. Inherited from RepositoryItemTextEdit.
ContextImageOptions Provides access to all properties that allow you to assign and customize a custom image displayed at the editor’s edge. Inherited from RepositoryItemTextEdit.
ContextMenu Gets or sets the context menu for the editor. Inherited from RepositoryItem.
DataSource Gets or sets the source of data displayed in the dropdown window. Inherited from RepositoryItemLookUpEditBase.
DefaultAlignment Gets the default alignment of the editor’s contents when the editor operates as an inplace control. Inherited from RepositoryItemLookUpEditBase.
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.
DesignMode protected Gets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DisplayFormat Gets format settings applied to the editor’s value. Inherited from RepositoryItem.
DisplayMember Gets or sets the field whose values are displayed in the edit box. Inherited from RepositoryItemLookUpEditBase.
DropDownItemHeight Gets or sets the height of a row in the dropdown (in pixels).
DropDownRows Gets or sets the height of the dropdown (in rows).
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.
EditorTypeName Gets the class name of an edit control corresponding to the current repository item.
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.
EditValueType Gets or sets whether the editor’s EditValue property returns a selected item, a list of selected items, or a string that combines DisplayMember property values of selected items.
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.
EnableEditValueCollectionEditing Gets or sets whether you can bind the LookUpEdit.EditValue property to a read-only property of a collection type. With this option enabled, the editor calls the collection’s methods to add and remove items.
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.
HeaderClickMode Gets or sets which functionality is invoked as a result of clicking a column header within the dropdown.
HideSelection Gets or sets whether the selection is hidden when moving focus to another control. Inherited from RepositoryItemTextEdit.
HighlightedItemStyle Specifies how selected and hot-tracked items are highlighted within the control’s popup window.
HotTrackItems Gets or sets a value specifying whether the items in the popup window are hottracked when the mouse pointer passes over them.
HotTrackRows Obsolete. Gets or sets a value specifying whether the rows in the popup window are hot-tracked when the mouse pointer passes over them.
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.
ImmediatePopup Gets or sets whether the popup window is displayed immediately after an end-user has typed a character in the edit box. Inherited from RepositoryItemPopupBaseAutoSearchEdit.
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.
IsEditValueChangedEventPending Gets whether the EditValueChanged event is postponed. Inherited from RepositoryItem.
IsFilterLookUp This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItemLookUpEditBase.
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.
KeyMember Gets or sets a string that specifies a key field (or multiple key fields) used for business object identification (when a lookup editor is bound to a business object). Inherited from RepositoryItemLookUpEditBase.
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.
Mask This member supports the .NET Framework infrastructure and cannot be used directly from your code. Inherited from RepositoryItemPopupBaseAutoSearchEdit.
MaskBoxPadding Gets or sets the amount of space around the text box embedded in the TextEdit. Inherited from RepositoryItemTextEdit.
MaskSettings For internal use. Inherited from RepositoryItemPopupBaseAutoSearchEdit.
MaxDisplayTextLength Gets or sets the maximum number of characters displayed in the edit box.
MaxLength Gets or sets the maximum number of characters an end-user can enter into the editor. Inherited from RepositoryItemTextEdit.
MaxToolTipTextLength static Gets or sets the maximum number of characters in the automatically generated tooltip displayed for an in-place editor. Inherited from RepositoryItemTextEdit.
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.
NullValuePrompt Gets or sets a grayed out hint displayed when the editor’s value is null or empty. This property is in effect for standalone editors and for editors embedded in toolbars and Ribbon controls. Not supported for in-place editors embedded in grid and tree list controls. Not supported for read-only editors. Inherited from RepositoryItemTextEdit.
NullValuePromptForeColor Inherited from RepositoryItemTextEdit.
NullValuePromptShowForEmptyValue Gets or sets whether the editor displays a prompt when its value is not specified (equals String.Empty). Inherited from RepositoryItemTextEdit.
OwnerEdit Gets the editor which owns the current repository item object.
OwnerItem This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from RepositoryItem.
Padding Gets or sets the TextEdit padding. The MemoEdit does not fully support this property, use the MaskBoxPadding property instead. Inherited from RepositoryItemTextEdit.
PasswordChar Gets or sets the password character that appears instead of actual characters. Inherited from RepositoryItemTextEdit.
PopupBorderStyle Gets or sets the popup window’s border style. Inherited from RepositoryItemPopupBase.
PopupFilterMode Gets or sets how data records in the popup window are filtered.
PopupFormMinSize Gets or sets the minimum size for the associated dropdown window. Inherited from RepositoryItemPopupBase.
PopupFormSize This property is not supported by the RepositoryItemLookUpEdit class.
PopupFormWidth Gets or sets the popup window’s width. Inherited from RepositoryItemPopupBase.
PopupOffset Gets or sets the popup window’s location. Inherited from RepositoryItem.
PopupResizeMode Gets or sets whether the popup window’s contents are displayed during resize operations. Inherited from RepositoryItemPopupBase.
PopupSizeable Gets or sets a value indicating whether the dropdown window is sizeable. Inherited from RepositoryItemLookUpEditBase.
PopupWidth Gets or sets the width of the dropdown window (in pixels).
PopupWidthMode Gets or sets whether the initial popup width matches the editor or content width. Inherited from RepositoryItemLookUpEditBase.
Properties Obsolete. Gets an object providing properties specific to the popup control. Inherited from RepositoryItemPopupBase.
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.
ResetTextEditStyleToStandardInFilterControl Gets or sets whether the RepositoryItemButtonEdit.TextEditStyle property is automatically set to TextEditStyles.Standard, when the editor is displayed within a FilterControl and FilterEditorControl. Inherited from RepositoryItemButtonEdit.
SearchMode Gets or sets whether to immediately apply the found value to the editor as a user types a query, or only highlight the found value in the drop-down window.
SelectFirstRowOnEnterKey Gets or sets whether the LookUp selects the first found item in the drop-down list when the user presses Enter.
SeparatorChar Gets or sets the character that separates selected items in the edit box.
ShowDropDown Gets or sets whether the popup window can be opened by clicking the edit box and whether a single or double click is required. Inherited from RepositoryItemPopupBase.
ShowFooter Gets or sets whether the dropdown window’s footer region is visible. Inherited from RepositoryItemLookUpEditBase.
ShowHeader Gets or sets the visibility of column headers.
ShowLines Gets or sets the visibility of vertical lines separating columns in the dropdown.
ShowNullValuePrompt Gets or sets conditions under which this editor should display its null value text (see the NullValuePrompt property). Inherited from RepositoryItemTextEdit.
ShowNullValuePromptWhenFocused Gets or sets whether the focused editor displays a prompt when its value is not specified. Inherited from RepositoryItemTextEdit.
ShowNullValuePromptWhenReadOnly Gets or sets whether the read-only editor displays a prompt when its value is not specified. Inherited from RepositoryItemTextEdit.
ShowPopupButtons Gets or sets whether to display OK and Cancel buttons in the popup.
ShowPopupShadow Gets or sets whether the popup window’s shadow is displayed. Inherited from RepositoryItemPopupBase.
Site Gets or sets a ISite for the object. Inherited from RepositoryItem.
SortColumnIndex Gets or sets the column index against which data is sorted.
SuppressMouseEventOnOuterMouseClick Allows you to suppress mouse events when clicking outside an open popup menu. Inherited from RepositoryItemPopupBase.
Tag Gets or sets the data associated with the repository item. Inherited from RepositoryItem.
TextEditStyle Gets or sets a value that specifies whether users can type in the lookup’s text box.
TextPadding Gets or sets the text (value) padding within the editor. Inherited from RepositoryItemTextEdit.
ThrowExceptionOnInvalidLookUpEditValueType Gets or sets whether the LookUp editor automatically detects data type issues and throws an exception. Inherited from RepositoryItemLookUpEditBase.
UseAdvancedMode Switches the editor to Advanced Mode. This mode supports new caret and selection animations, emojis, and embedded labels. You can set up properties from the RepositoryItemTextEdit.AdvancedModeOptions group to choose which Advanced Mode features are enabled. Inherited from RepositoryItemTextEdit.
UseCtrlScroll Gets or sets whether you should use the CTRL+UP-DOWN ARROW/CTRL+MOUSE WHEEL or UP-DOWN ARROW/MOUSE WHEEL combinations to scroll lookup records when the pop-up window is closed. Inherited from RepositoryItemLookUpEditBase.
UseDropDownRowsAsMaxCount Gets or sets whether the number of visible data rows limits the height of the dropdown window.
UseMaskAsDisplayFormat For internal use. Inherited from RepositoryItemPopupBaseAutoSearchEdit.
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 the TextEdit is grayed out in the read only mode. Inherited from RepositoryItemTextEdit.
UseSystemPasswordChar Gets or sets whether password mode is active and the system password character is used to mask the editor’s text. Inherited from RepositoryItemTextEdit.
UseTextEditorForAutoFilter Gets whether to substitute this editor with the single-line text editor in auto-filter rows. Inherited from RepositoryItemButtonEdit.
ValidateOnEnterKey Gets or sets whether to raise the RepositoryItem.Validating event on pressing the ENTER key. Inherited from RepositoryItemTextEdit.
ValueMember Gets or sets the field name whose values identify dropdown rows. Inherited from RepositoryItemLookUpEditBase.
XlsxFormatString Gets or sets the native Excel format string used to format the editor’s value when exporting to XLSX. This property is in effect in WYSIWYG export mode. Inherited from RepositoryItemTextEdit.
See Also