ClassDropDownPopupForm
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, ISupportRootUIAutomationInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPopupControlBaseRadSizablePopupControlRadEditorPopupControlBaseDropDownPopupForm
Derived Classes:
Implements:
Inherited Members
Constructors
DropDownPopupForm(RadDropDownListElement)
Initializes a new instance of the DropDownPopupForm class with the specified owner dropdown list element.
Declaration
public DropDownPopupForm(RadDropDownListElement ownerDropDownListElement)Parameters
ownerDropDownListElement
The RadDropDownListElement that owns this popup form.
Properties
EnableUIAutomation
Gets or sets a value indicating whether UI Automation support is enabled for this popup form.
Declaration
public override bool EnableUIAutomation { get; set; }Property Value
Overrides
Implements
LastPressedKey
Gets or sets the last pressed key in the popup form. This is used to track keyboard navigation state.
OwnerDropDownListElement
Gets the RadDropDownListElement that owns this popup form.
Declaration
public RadDropDownListElement OwnerDropDownListElement { get; }Property Value
Methods
CanClosePopup(RadPopupCloseReason)
Determines whether the popup can be closed for the specified reason by checking current mouse button state.
Declaration
public override bool CanClosePopup(RadPopupCloseReason reason)Parameters
reason
The RadPopupCloseReason indicating why the popup is requested to close.
Returns
True if the popup can be closed; otherwise, false.
Overrides
CanClosePopupCore(MouseButtons, RadPopupCloseReason)
Determines whether the popup can be closed based on mouse button state, close reason, and various UI element states including scrollbars and sizing grip.
Declaration
protected virtual bool CanClosePopupCore(MouseButtons mouseButtons, RadPopupCloseReason reason)Parameters
mouseButtons
The current MouseButtons state.
reason
The RadPopupCloseReason indicating why the popup is requested to close.
Returns
True if the popup can be closed; otherwise, false.
ClosePopup(RadPopupCloseReason)
Closes the popup form with the specified reason and notifies the owner dropdown list element.
Declaration
public override void ClosePopup(RadPopupCloseReason reason)Parameters
reason
The RadPopupCloseReason indicating why the popup is being closed.
Overrides
CreateAccessibilityInstance()
Creates an accessibility instance for the dropdown popup form to support assistive technologies.
Declaration
protected override AccessibleObject CreateAccessibilityInstance()Returns
An AccessibleObject that provides accessibility support for the popup form.
Overrides
GetMainDropDownListElement()
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.
Declaration
protected RadDropDownListElement GetMainDropDownListElement()Returns
The main RadDropDownListElement that is not in suggest mode.
GetSelectedOrHoveredItem()
Gets the currently selected or hovered item from the dropdown list, prioritizing newly selected items over the initially selected item.
Declaration
protected RadListDataItem GetSelectedOrHoveredItem()Returns
The RadListDataItem that is selected or hovered, or null if no such item exists.
HandleKeyDown(Keys)
Handles specific key down events including navigation keys (Up, Down, PageUp, PageDown, Home, End), Tab, Enter, and Backspace.
HandleMouseClick(MouseEventArgs)
Handles mouse click events and determines whether the popup should be closed based on kinetic scrolling state and click conditions.
Declaration
protected virtual void HandleMouseClick(MouseEventArgs e)Parameters
e
The MouseEventArgs containing event data.
OnKeyDown(Keys)
Handles key down events for the popup form, processing navigation and special keys while managing keyboard search behavior.
OnLoad(Size)
Handles the loading of the popup form and enables pan gesture support for touch interactions.
Declaration
protected override void OnLoad(Size desiredSize)Parameters
desiredSize
The desired size for the popup form.
Overrides
OnMouseClick(MouseEventArgs)
Handles mouse click events and delegates to the HandleMouseClick(MouseEventArgs) method for processing.
Declaration
protected override void OnMouseClick(MouseEventArgs e)Parameters
e
The MouseEventArgs containing event data.
Overrides
OnMouseDown(MouseEventArgs)
Handles mouse down events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
Declaration
protected override void OnMouseDown(MouseEventArgs e)Parameters
e
The MouseEventArgs containing event data.
Overrides
OnMouseMove(MouseEventArgs)
Handles mouse move events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
Declaration
protected override void OnMouseMove(MouseEventArgs e)Parameters
e
The MouseEventArgs containing event data.
Overrides
OnMouseUp(MouseEventArgs)
Handles mouse up events by delegating to the owner dropdown list element if available, otherwise processes the event normally.
Declaration
protected override void OnMouseUp(MouseEventArgs e)Parameters
e
The MouseEventArgs containing event data.
Overrides
OnMouseWheel(Control, int)
Handles mouse wheel events for scrolling within the dropdown list, respecting the owner's mouse wheel settings.
Declaration
public override bool OnMouseWheel(Control target, int delta)Parameters
target
The target Control receiving the mouse wheel event.
delta
The delta value indicating the scroll direction and amount.
Returns
Always returns true to indicate the event was handled.
Overrides
ProcessFocusRequested(RadElement)
Processes focus requests for elements within the popup form. Always returns false to prevent focus changes within the popup.
Declaration
protected override bool ProcessFocusRequested(RadElement element)Parameters
element
The RadElement requesting focus.
Returns
Always returns false to deny focus requests.
Overrides
WndProc(ref Message)
Processes Windows messages, specifically handling UI Automation related messages for accessibility support.
Declaration
protected override void WndProc(ref Message m)Parameters
m
The Windows message to process.
Overrides