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
public RadDomainUpDownElement()Properties
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.
public bool AutoComplete { get; set; }Gets the element representing the down navigation button. This button allows users to move to the next item in the collection.
public RadRepeatArrowElement DownButtonElement { get; }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.
public bool ReadOnly { get; set; }Gets the element representing the up navigation button. This button allows users to move to the previous item in the collection.
public RadRepeatArrowElement UpButtonElement { get; }Methods
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.
protected override bool CanCreateArrowButtonElement()Always returns false to prevent creation of the standard dropdown arrow button.
Overrides:
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.
protected override void CreateChildElements()Overrides:
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.
protected virtual RadRepeatArrowElement CreateDownButton()A RadRepeatArrowElement configured as a down button for downward navigation.
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.
protected override StackLayoutElement CreateElementsContainer()A StackLayoutElement that serves as the main container for the domain up-down elements.
Overrides:
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.
protected virtual RadRepeatArrowElement CreateUpButton()A RadRepeatArrowElement configured as an up button for upward navigation.
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.
protected override void HandleOnKeyUpKeyDownPress(KeyEventArgs keyEventArgs)The key event arguments containing information about the pressed key.
Overrides:
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.
public virtual void MoveDown(bool wrap)Specifies whether the navigation will wrap from the last item to the first item when at the end of the collection.
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.
public virtual void MoveUp(bool wrap)Specifies whether the navigation will wrap from the first item to the last item when at the beginning of the collection.
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.
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.
protected override void OnMouseWheelCore(MouseEventArgs e)The mouse event arguments containing information about the mouse wheel movement.
Overrides:
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.
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.
protected override void TooglePopupState()Overrides:
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.
protected override void UnwireEvents()Overrides: