DropDownPopupForm
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class DropDownPopupForm : RadEditorPopupControlBase, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IPopupControl, ISupportRootUIAutomation
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPopupControlBaseRadSizablePopupControlRadEditorPopupControlBaseDropDownPopupForm...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the DropDownPopupForm class with the specified owner dropdown list element.
public DropDownPopupForm(RadDropDownListElement ownerDropDownListElement)
The RadDropDownListElement that owns this popup form.
Properties
Gets or sets a value indicating whether UI Automation support is enabled for this popup form.
public override bool EnableUIAutomation { get; set; }
Overrides:
Implements:
Gets or sets the last pressed key in the popup form. This is used to track keyboard navigation state.
public Keys? LastPressedKey { get; }
Gets the RadDropDownListElement that owns this popup form.
public RadDropDownListElement OwnerDropDownListElement { get; }
Methods
Determines whether the popup can be closed for the specified reason by checking current mouse button state.
public override bool CanClosePopup(RadPopupCloseReason reason)
The RadPopupCloseReason indicating why the popup is requested to close.
Returns:True if the popup can be closed; otherwise, false.
Overrides:
Determines whether the popup can be closed based on mouse button state, close reason, and various UI element states including scrollbars and sizing grip.
protected virtual bool CanClosePopupCore(MouseButtons mouseButtons, RadPopupCloseReason reason)
The current MouseButtons state.
reasonRadPopupCloseReasonThe RadPopupCloseReason indicating why the popup is requested to close.
Returns:True if the popup can be closed; otherwise, false.
Closes the popup form with the specified reason and notifies the owner dropdown list element.
public override void ClosePopup(RadPopupCloseReason reason)
The RadPopupCloseReason indicating why the popup is being closed.
Overrides:
Creates an accessibility instance for the dropdown popup form to support assistive technologies.
protected override AccessibleObject CreateAccessibilityInstance()
An AccessibleObject that provides accessibility support for the popup form.
Overrides:
Gets the main (non-suggest mode) dropdown list element. If the current element is in suggest mode, returns its parent; otherwise, returns the current element.
protected RadDropDownListElement GetMainDropDownListElement()
The main RadDropDownListElement that is not in suggest mode.
Gets the currently selected or hovered item from the dropdown list, prioritizing newly selected items over the initially selected item.
protected RadListDataItem GetSelectedOrHoveredItem()
The RadListDataItem that is selected or hovered, or null if no such item exists.
Handles specific key down events including navigation keys (Up, Down, PageUp, PageDown, Home, End), Tab, Enter, and Backspace.
Handles mouse click events and determines whether the popup should be closed based on kinetic scrolling state and click conditions.
protected virtual void HandleMouseClick(MouseEventArgs e)
The MouseEventArgs containing event data.
Handles key down events for the popup form, processing navigation and special keys while managing keyboard search behavior.
Handles the loading of the popup form and enables pan gesture support for touch interactions.
protected override void OnLoad(Size desiredSize)
The desired size for the popup form.
Overrides:
Handles mouse click events and delegates to the HandleMouseClick(MouseEventArgs) method for processing.
protected override void OnMouseClick(MouseEventArgs e)
The MouseEventArgs containing event data.
Overrides:
Handles mouse down events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
protected override void OnMouseDown(MouseEventArgs e)
The MouseEventArgs containing event data.
Overrides:
Handles mouse move events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
protected override void OnMouseMove(MouseEventArgs e)
The MouseEventArgs containing event data.
Overrides:
Handles mouse up events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
protected override void OnMouseUp(MouseEventArgs e)
The MouseEventArgs containing event data.
Overrides:
Handles mouse wheel events for scrolling within the dropdown list, respecting the owner's mouse wheel settings.
Processes focus requests for elements within the popup form. Always returns false to prevent focus changes within the popup.
protected override bool ProcessFocusRequested(RadElement element)
The RadElement requesting focus.
Returns:Always returns false to deny focus requests.
Overrides:
Processes Windows messages, specifically handling UI Automation related messages for accessibility support.
protected override void WndProc(ref Message m)
The Windows message to process.
Overrides: