ClassRadDomainUpDownElement
Represents the main element that provides domain up-down functionality by combining text editing with up/down navigation buttons. This element extends RadDropDownListElement to provide a specialized interface for navigating through a predefined collection of items using directional buttons instead of a traditional dropdown list.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadDomainUpDownElement : RadDropDownListElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IInputEditor, IValueEditor, ISupportInitializeInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadEditorElementEditorBaseElementPopupEditorBaseElementPopupEditorElementRadDropDownListElementRadDomainUpDownElement
Implements:
Inherited Members
Constructors
RadDomainUpDownElement()
Declaration
public RadDomainUpDownElement()Properties
AutoComplete
Gets or sets a value indicating whether auto-complete is enabled. When enabled, the matched item's text will be appended to the input in the editor as the user types.
DownButtonElement
Gets the element representing the down navigation button. This button allows users to move to the next item in the collection.
Declaration
public RadRepeatArrowElement DownButtonElement { get; }Property Value
ReadOnly
Gets or sets a value indicating whether typing is enabled inside the text box. When set to true, the control becomes read-only and users can only navigate using the up/down buttons or keyboard.
UpButtonElement
Gets the element representing the up navigation button. This button allows users to move to the previous item in the collection.
Declaration
public RadRepeatArrowElement UpButtonElement { get; }Property Value
Wrap
Gets or sets a value indicating whether the selected item will revert to the first item after reaching the last item and vice versa. When enabled, navigation wraps around the collection boundaries to provide continuous circular navigation.
Methods
CanCreateArrowButtonElement()
Determines whether an arrow button element should be created for the dropdown functionality. For domain up-down controls, this returns false since navigation is handled by the dedicated up/down buttons.
Declaration
protected override bool CanCreateArrowButtonElement()Returns
Always returns false to prevent creation of the standard dropdown arrow button.
Overrides
CreateChildElements()
Creates the visual elements that make up the RadDomainUpDownElement. This method initializes the button layout container, creates up and down navigation buttons, and configures the overall element structure for the domain up-down control.
Declaration
protected override void CreateChildElements()Overrides
CreateDownButton()
Creates the down navigation button element that allows users to move to the next item in the collection. This method can be overridden in derived classes to provide custom down button implementations.
Declaration
protected virtual RadRepeatArrowElement CreateDownButton()Returns
A RadRepeatArrowElement configured as a down button for downward navigation.
CreateElementsContainer()
Creates the container element that holds all child elements of the domain up-down control. This method establishes the main layout structure for organizing the text editor and navigation buttons.
Declaration
protected override StackLayoutElement CreateElementsContainer()Returns
A StackLayoutElement that serves as the main container for the domain up-down elements.
Overrides
CreateUpButton()
Creates the up navigation button element that allows users to move to the previous item in the collection. This method can be overridden in derived classes to provide custom up button implementations.
Declaration
protected virtual RadRepeatArrowElement CreateUpButton()Returns
A RadRepeatArrowElement configured as an up button for upward navigation.
HandleOnKeyUpKeyDownPress(KeyEventArgs)
Handles keyboard navigation when Up or Down arrow keys are pressed. This method provides keyboard support for navigating through items using arrow keys with proper wrap behavior.
Declaration
protected override void HandleOnKeyUpKeyDownPress(KeyEventArgs keyEventArgs)Parameters
keyEventArgs
The key event arguments containing information about the pressed key.
Overrides
MoveDown(bool)
Selects the next item in the list, optionally wrapping to the first item if at the end. This method handles downward navigation through the item collection with proper boundary checking.
Declaration
public virtual void MoveDown(bool wrap)Parameters
wrap
Specifies whether the navigation will wrap from the last item to the first item when at the end of the collection.
MoveUp(bool)
Selects the previous item in the list, optionally wrapping to the last item if at the beginning. This method handles upward navigation through the item collection with proper boundary checking.
Declaration
public virtual void MoveUp(bool wrap)Parameters
wrap
Specifies whether the navigation will wrap from the first item to the last item when at the beginning of the collection.
OnDownButtonClick(object, EventArgs)
Handles the click event of the down button to navigate to the next item. This method is called when the user clicks the down arrow button and triggers downward navigation with the current wrap setting.
OnMouseWheelCore(MouseEventArgs)
Handles mouse wheel events to provide scrolling navigation through items. This method enables users to navigate through the item collection using the mouse wheel with proper wrap behavior.
Declaration
protected override void OnMouseWheelCore(MouseEventArgs e)Parameters
e
The mouse event arguments containing information about the mouse wheel movement.
Overrides
OnUpButtonClick(object, EventArgs)
Handles the click event of the up button to navigate to the previous item. This method is called when the user clicks the up arrow button and triggers upward navigation with the current wrap setting.
TooglePopupState()
Overrides the base toggle popup functionality to prevent popup display. In domain up-down controls, popup functionality is disabled since navigation is handled through the up/down buttons.
Declaration
protected override void TooglePopupState()Overrides
UnwireEvents()
Detaches event handlers from the up and down button elements during cleanup. This method ensures proper resource cleanup and prevents memory leaks by removing event subscriptions.
Declaration
protected override void UnwireEvents()Overrides