Class
RadDropDownButton

A DropDownButton control.

Definition

Namespace:Telerik.UI.Xaml.Controls

Assembly:Telerik.WinUI.Controls.dll

Syntax:

cs-api-definition
public class RadDropDownButton : RadButton, ICommandSource, IDisposable

Inheritance: objectRadButtonRadDropDownButton

Derived Classes: RadSplitButton

Implements: ICommandSourceIDisposable

Inherited Members RadButton.CommandParameterPropertyRadButton.CommandPropertyRadButton.CommandTargetPropertyRadButton.ExecuteCommand()RadButton.CommandRadButton.CommandParameterRadButton.CommandTarget

Constructors

RadDropDownButton()

Initializes a new instance of the RadDropDownButton class.

Declaration

cs-api-definition
public RadDropDownButton()

Fields

AutoOpenDelayProperty

Identifies the AutoOpenDelay property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoOpenDelayProperty

Field Value

DependencyProperty

CloseOnEnterProperty

Identifies the CloseOnEnter property.

Declaration

cs-api-definition
public static readonly DependencyProperty CloseOnEnterProperty

Field Value

DependencyProperty

CloseOnEscapeProperty

Identifies the CloseOnEscape property.

Declaration

cs-api-definition
public static readonly DependencyProperty CloseOnEscapeProperty

Field Value

DependencyProperty

CloseOnPopupMouseLeftButtonUpProperty

Identifies the CloseOnPopupMouseLeftButtonUp property.

Declaration

cs-api-definition
public static readonly DependencyProperty CloseOnPopupMouseLeftButtonUpProperty

Field Value

DependencyProperty

DropDownButtonPositionProperty

Identifies the DropDownButtonPosition property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownButtonPositionProperty

Field Value

DependencyProperty

DropDownClosedEvent

Identifies the DropDownClosed property.

Declaration

cs-api-definition
public static readonly RoutedEvent DropDownClosedEvent

Field Value

RoutedEvent

DropDownContentProperty

Identifies the DropDownContent property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownContentProperty

Field Value

DependencyProperty

DropDownContentTemplateProperty

Identifies the DropDownContentTemplate property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownContentTemplateProperty

Field Value

DependencyProperty

DropDownContentTemplateSelectorProperty

Identifies the DropDownContentTemplateSelector property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownContentTemplateSelectorProperty

Field Value

DependencyProperty

DropDownHeightProperty

Identifies the PopupHeight property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownHeightProperty

Field Value

DependencyProperty

DropDownIndicatorVisibilityProperty

Identifies the DropDownContent property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownIndicatorVisibilityProperty

Field Value

DependencyProperty

DropDownMaxHeightProperty

Identifies the PopupMaxHeight property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMaxHeightProperty

Field Value

DependencyProperty

DropDownMaxWidthProperty

Identifies the PopupMaxWidth property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMaxWidthProperty

Field Value

DependencyProperty

DropDownMinHeightProperty

Identifies the DropDownMinHeight property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMinHeightProperty

Field Value

DependencyProperty

DropDownMinWidthProperty

Identifies the DropDownMinWidth property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMinWidthProperty

Field Value

DependencyProperty

DropDownOpenedEvent

Identifies the DropDownOpened property.

Declaration

cs-api-definition
public static readonly RoutedEvent DropDownOpenedEvent

Field Value

RoutedEvent

DropDownOpeningEvent

Identifies the DropDownOpening property.

Declaration

cs-api-definition
public static readonly RoutedEvent DropDownOpeningEvent

Field Value

RoutedEvent

DropDownPlacementProperty

Identifies the DropDownPlacement property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownPlacementProperty

Field Value

DependencyProperty

DropDownWidthProperty

Identifies the PopupWidth property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownWidthProperty

Field Value

DependencyProperty

IsOpenProperty

Identifies the IsOpen property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsOpenProperty

Field Value

DependencyProperty

KeepOpenProperty

Identifies the KeepOpen property.

Declaration

cs-api-definition
public static readonly DependencyProperty KeepOpenProperty

Field Value

DependencyProperty

PopupPlacementTargetProperty

Identifies the PopupPlacementTarget property.

Declaration

cs-api-definition
public static readonly DependencyProperty PopupPlacementTargetProperty

Field Value

DependencyProperty

Properties

AutoOpenDelay

Gets or sets whether the popup opens when mouse hovers for pointed milliseconds. Value of zero means no auto open. This is a dependency property.

Declaration

cs-api-definition
[Browsable(false)]
public TimeSpan AutoOpenDelay { get; set; }

Property Value

TimeSpan

CloseOnEnter

Gets or sets whether the popup closes when the Enter key toggles. This is a dependency property.

Declaration

cs-api-definition
public bool CloseOnEnter { get; set; }

Property Value

bool

CloseOnEscape

Gets or sets whether the popup closes when the Escape key toggles. This is a dependency property.

Declaration

cs-api-definition
public bool CloseOnEscape { get; set; }

Property Value

bool

CloseOnPopupMouseLeftButtonUp

Gets or sets whether the Popup should be closed when the user clicks on the DropDownContent. The closing is executed on MouseLeftButtonUp event of the Popup. This is a dependency property.

Declaration

cs-api-definition
public bool CloseOnPopupMouseLeftButtonUp { get; set; }

Property Value

bool

DropDownButtonPosition

Gets or sets the position of the drop down indicator. This is a dependency property.

Declaration

cs-api-definition
public DropDownButtonPosition DropDownButtonPosition { get; set; }

Property Value

DropDownButtonPosition

DropDownContent

Gets or sets the drop-down area's content. This is a dependency property.

Declaration

cs-api-definition
public object DropDownContent { get; set; }

Property Value

object

DropDownContentTemplate

Gets or sets the template used to display the drop-down content of the button. This is a dependency property.

Declaration

cs-api-definition
public DataTemplate DropDownContentTemplate { get; set; }

Property Value

DataTemplate

DropDownContentTemplateSelector

Gets or sets the template-selector used to display the drop-down content of the button. This is a dependency property.

Declaration

cs-api-definition
public DataTemplateSelector DropDownContentTemplateSelector { get; set; }

Property Value

DataTemplateSelector

DropDownHeight

Gets or sets the Height of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownHeight { get; set; }

Property Value

double

DropDownIndicatorVisibility

Gets or sets whether the DropDown indicator is visible. This is a dependency property.

Declaration

cs-api-definition
public Visibility DropDownIndicatorVisibility { get; set; }

Property Value

Visibility

DropDownMaxHeight

Gets or sets the MaxHeight of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownMaxHeight { get; set; }

Property Value

double

DropDownMaxWidth

Gets or sets the MaxWidth of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownMaxWidth { get; set; }

Property Value

double

DropDownMinHeight

Gets or sets the MinHeight of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownMinHeight { get; set; }

Property Value

double

DropDownMinWidth

Gets or sets the MinWidth of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownMinWidth { get; set; }

Property Value

double

DropDownPlacement

Gets or sets the position of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public PlacementMode DropDownPlacement { get; set; }

Property Value

PlacementMode

DropDownWidth

Gets or sets the Width of the drop-down area. This is a dependency property.

Declaration

cs-api-definition
public double DropDownWidth { get; set; }

Property Value

double

IsOpen

Gets or sets whether the drop-down area is opened. This is a dependency property.

Declaration

cs-api-definition
public bool IsOpen { get; set; }

Property Value

bool

KeepOpen

Gets or sets whether the drop-down area should remain opened. This is a dependency property.

Declaration

cs-api-definition
public bool KeepOpen { get; set; }

Property Value

bool

PopupPlacementTarget

Get/set the placement for the popup element.

Declaration

cs-api-definition
public FrameworkElement PopupPlacementTarget { get; set; }

Property Value

FrameworkElement

Methods

ApplyDropDownButtonPosition()

Initializes the position of the DropDown indicator and correct the placement of the Popup window.

Declaration

cs-api-definition
protected virtual void ApplyDropDownButtonPosition()

ApplyPopupPlacement()

Set the placement of the Popup window.

Declaration

cs-api-definition
protected virtual void ApplyPopupPlacement()

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration

cs-api-definition
public void Dispose()

Implements IDisposable.Dispose()

Finalize()

Releases unmanaged resources and performs other cleanup operations before the RadDropDownButton is reclaimed by garbage collection.

Declaration

cs-api-definition
protected override void Finalize()

HandleKeyDown(object, KeyRoutedEventArgs)

Declaration

cs-api-definition
protected virtual void HandleKeyDown(object sender, KeyRoutedEventArgs e)

Parameters

sender

object

e

KeyRoutedEventArgs

HoverTimerApplyState(bool)

Declaration

cs-api-definition
protected bool HoverTimerApplyState(bool applyAction)

Parameters

applyAction

bool

Returns

bool

HoverTimerDestroy()

Declaration

cs-api-definition
protected void HoverTimerDestroy()

HoverTimerRestart()

Declaration

cs-api-definition
protected void HoverTimerRestart()

HoverTimerStart()

Declaration

cs-api-definition
protected void HoverTimerStart()

HoverTimerStop()

Declaration

cs-api-definition
protected void HoverTimerStop()

OnApplyTemplate()

Invoked whenever application code or internal processes (such as a rebuilding layout pass) call .

Declaration

cs-api-definition
protected override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates a RadDropDownButtonAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

Overrides RadButton.OnCreateAutomationPeer()

OnDropDownContentChanged(object, object)

Called when the DropDownContent property of a RadDropDownButton changes.

Declaration

cs-api-definition
protected virtual void OnDropDownContentChanged(object oldValue, object newValue)

Parameters

oldValue

object

The old value of the DropDownContent property.

newValue

object

The new value of the DropDownContent property.

OnDropDownContentTemplateChanged(DataTemplate, DataTemplate)

Called when the DropDownContentTemplate property of a RadDropDownButton changes.

Declaration

cs-api-definition
protected virtual void OnDropDownContentTemplateChanged(DataTemplate oldValue, DataTemplate newValue)

Parameters

oldValue

DataTemplate

The old value of the DropDownContentTemplate property.

newValue

DataTemplate

The new value of the DropDownContentTemplate property.

OnDropDownContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

Called when the DropDownContentTemplateSelector property of a RadDropDownButton changes.

Declaration

cs-api-definition
protected virtual void OnDropDownContentTemplateSelectorChanged(DataTemplateSelector oldValue, DataTemplateSelector newValue)

Parameters

oldValue

DataTemplateSelector

The old value of the DropDownContentTemplateSelector property.

newValue

DataTemplateSelector

The new value of the DropDownContentTemplateSelector property.

OnDropDownPlacementChanged(DataTemplate, DataTemplate)

Called when the DropDownPlacement property of a RadDropDownButton changes.

Declaration

cs-api-definition
protected virtual void OnDropDownPlacementChanged(DataTemplate oldValue, DataTemplate newValue)

Parameters

oldValue

DataTemplate

The old value of the DropDownPlacement property.

newValue

DataTemplate

The new value of the DropDownPlacement property.

OnHoverTimerTick(object, object)

Declaration

cs-api-definition
protected void OnHoverTimerTick(object sender, object e)

Parameters

sender

object

e

object

OnIsOpenChanged(bool, bool)

Called when [is open changed].

Declaration

cs-api-definition
protected virtual void OnIsOpenChanged(bool newValue, bool oldValue)

Parameters

newValue

bool

The new value.

oldValue

bool

The old value.

OnPointerEntered(PointerRoutedEventArgs)

Declaration

cs-api-definition
protected override void OnPointerEntered(PointerRoutedEventArgs e)

Parameters

e

PointerRoutedEventArgs

OnPointerExited(PointerRoutedEventArgs)

Declaration

cs-api-definition
protected override void OnPointerExited(PointerRoutedEventArgs e)

Parameters

e

PointerRoutedEventArgs

OnPointerMoved(PointerRoutedEventArgs)

Declaration

cs-api-definition
protected override void OnPointerMoved(PointerRoutedEventArgs e)

Parameters

e

PointerRoutedEventArgs

OnPointerPressed(PointerRoutedEventArgs)

Declaration

cs-api-definition
protected override void OnPointerPressed(PointerRoutedEventArgs e)

Parameters

e

PointerRoutedEventArgs

Events

DropDownClosed

Occurs when the Popup is closed.

Declaration

cs-api-definition
public event RoutedEventHandler DropDownClosed

Event Value

RoutedEventHandler

DropDownOpened

Occurs when the Popup is opened.

Declaration

cs-api-definition
public event RoutedEventHandler DropDownOpened

Event Value

RoutedEventHandler

DropDownOpening

Occurs when the Popup is opening.

Declaration

cs-api-definition
public event RoutedEventHandler DropDownOpening

Event Value

RoutedEventHandler

In this article
DefinitionConstructorsRadDropDownButton()FieldsAutoOpenDelayPropertyCloseOnEnterPropertyCloseOnEscapePropertyCloseOnPopupMouseLeftButtonUpPropertyDropDownButtonPositionPropertyDropDownClosedEventDropDownContentPropertyDropDownContentTemplatePropertyDropDownContentTemplateSelectorPropertyDropDownHeightPropertyDropDownIndicatorVisibilityPropertyDropDownMaxHeightPropertyDropDownMaxWidthPropertyDropDownMinHeightPropertyDropDownMinWidthPropertyDropDownOpenedEventDropDownOpeningEventDropDownPlacementPropertyDropDownWidthPropertyIsOpenPropertyKeepOpenPropertyPopupPlacementTargetPropertyPropertiesAutoOpenDelayCloseOnEnterCloseOnEscapeCloseOnPopupMouseLeftButtonUpDropDownButtonPositionDropDownContentDropDownContentTemplateDropDownContentTemplateSelectorDropDownHeightDropDownIndicatorVisibilityDropDownMaxHeightDropDownMaxWidthDropDownMinHeightDropDownMinWidthDropDownPlacementDropDownWidthIsOpenKeepOpenPopupPlacementTargetMethodsApplyDropDownButtonPosition()ApplyPopupPlacement()Dispose()Finalize()HandleKeyDown(object, KeyRoutedEventArgs)HoverTimerApplyState(bool)HoverTimerDestroy()HoverTimerRestart()HoverTimerStart()HoverTimerStop()OnApplyTemplate()OnCreateAutomationPeer()OnDropDownContentChanged(object, object)OnDropDownContentTemplateChanged(DataTemplate, DataTemplate)OnDropDownContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)OnDropDownPlacementChanged(DataTemplate, DataTemplate)OnHoverTimerTick(object, object)OnIsOpenChanged(bool, bool)OnPointerEntered(PointerRoutedEventArgs)OnPointerExited(PointerRoutedEventArgs)OnPointerMoved(PointerRoutedEventArgs)OnPointerPressed(PointerRoutedEventArgs)EventsDropDownClosedDropDownOpenedDropDownOpening
Not finding the help you need?
Contact Support