Class DropDownPopupForm

Inheritance
System.Object
RadControl
RadPopupControlBase
RadSizablePopupControl
RadEditorPopupControlBase
DropDownPopupForm
BreadCrumbAutoCompleteDropDownPopupForm
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class DropDownPopupForm : RadEditorPopupControlBase, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, IPopupControl, ISupportRootUIAutomation

Constructors

DropDownPopupForm(RadDropDownListElement)

Initializes a new instance of the DropDownPopupForm class with the specified owner dropdown list element.

Declaration
public DropDownPopupForm(RadDropDownListElement ownerDropDownListElement)
Parameters
RadDropDownListElement 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
System.Boolean

Overrides
Implements

LastPressedKey

Gets or sets the last pressed key in the popup form. This is used to track keyboard navigation state.

Declaration
public Keys? LastPressedKey { get; }
Property Value
System.Nullable<System.Windows.Forms.Keys>

OwnerDropDownListElement

Gets the RadDropDownListElement that owns this popup form.

Declaration
public RadDropDownListElement OwnerDropDownListElement { get; }
Property Value
RadDropDownListElement

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
RadPopupCloseReason reason

The RadPopupCloseReason indicating why the popup is requested to close.
Returns
System.Boolean

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
System.Windows.Forms.MouseButtons mouseButtons

The current System.Windows.Forms.MouseButtons state.
RadPopupCloseReason reason

The RadPopupCloseReason indicating why the popup is requested to close.
Returns
System.Boolean

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
RadPopupCloseReason 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
System.Windows.Forms.AccessibleObject

An System.Windows.Forms.AccessibleObject that provides accessibility support for the popup form.

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
RadDropDownListElement

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
RadListDataItem

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.

Declaration
protected virtual bool? HandleKeyDown(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

The System.Windows.Forms.Keys value representing the key that was pressed.
Returns
System.Nullable<System.Boolean>

True if the key was handled, false if not handled, or null if the base class should handle it.

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
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs containing event data.

OnKeyDown(Keys)

Handles key down events for the popup form, processing navigation and special keys while managing keyboard search behavior.

Declaration
public override bool OnKeyDown(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

The System.Windows.Forms.Keys value representing the key that was pressed.
Returns
System.Boolean

True if the key was handled; otherwise, false.
Overrides

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
System.Drawing.Size 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
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs containing event data.

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
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.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
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.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
System.Windows.Forms.MouseEventArgs e

The System.Windows.Forms.MouseEventArgs containing event data.
Overrides

OnMouseWheel(Control, Int32)

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
System.Windows.Forms.Control target

The target System.Windows.Forms.Control receiving the mouse wheel event.
System.Int32 delta

The delta value indicating the scroll direction and amount.
Returns
System.Boolean

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
RadElement element

The RadElement requesting focus.
Returns
System.Boolean

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
System.Windows.Forms.Message m

The Windows message to process.
Overrides

Explicit Interface Implementations

ISupportRootUIAutomation.DisposeUIAutomationProvider()

Declaration
void ISupportRootUIAutomation.DisposeUIAutomationProvider()
Implements

ISupportRootUIAutomation.InitializeUIAutomationProvider()

Declaration
void ISupportRootUIAutomation.InitializeUIAutomationProvider()
Implements

ISupportRootUIAutomation.RootUIAutomationManager

Gets the root UI Automation manager responsible for managing UI Automation providers and handling automation-related functionality for this popup form.

Declaration
IRootUIAutomationManager ISupportRootUIAutomation.RootUIAutomationManager { get; }
Returns
IRootUIAutomationManager

Implements

ISupportRootUIAutomation.UIAutomationProvider

Gets the UI Automation provider that enables assistive technologies to interact with this popup form and provides accessibility information.

Declaration
IRadRawElementProviderFragmentRoot ISupportRootUIAutomation.UIAutomationProvider { get; }
Returns
IRadRawElementProviderFragmentRoot

Implements

Extension Methods