New to Telerik UI for .NET MAUI? Start a free 30-day trial

RadDropDownButton

Class

Represents a customizable drop-down button that combines the functionalities of a standard button and a pop-up. The RadDropDownButton allows for displaying a drop-down content area when clicked, enabling users to select options or display additional information.

Definition

Namespace:Telerik.Maui.Controls

Assembly:Telerik.Maui.Controls.dll

Syntax:

public class RadDropDownButton : RadTemplatedButton, INotifyPropertyChanged

Inheritance: objectRadButtonBaseRadTemplatedButtonRadDropDownButton

Implements: INotifyPropertyChanged

Constructors

RadDropDownButton()

Initializes a new instance of the RadDropDownButton class.

public RadDropDownButton()

Fields

ActualDropDownIndicatorStyleProperty

BindableProperty

Identifies the ActualDropDownIndicatorStyle bindable property.

public static readonly BindableProperty ActualDropDownIndicatorStyleProperty

AutoOpenDelayProperty

BindableProperty

Identifies the AutoOpenDelay bindable property.

public static readonly BindableProperty AutoOpenDelayProperty

DropDownAnimationDurationProperty

BindableProperty

Identifies the DropDownAnimationDuration bindable property.

public static readonly BindableProperty DropDownAnimationDurationProperty

DropDownAnimationEasingProperty

BindableProperty

Identifies the DropDownAnimationEasing bindable property.

public static readonly BindableProperty DropDownAnimationEasingProperty

DropDownAnimationProperty

BindableProperty

Identifies the DropDownAnimation bindable property.

public static readonly BindableProperty DropDownAnimationProperty

DropDownBackgroundColorProperty

BindableProperty

Identifies the DropDownBackgroundColor bindable property.

public static readonly BindableProperty DropDownBackgroundColorProperty

DropDownBorderColorProperty

BindableProperty

Identifies the DropDownBorderColor bindable property.

public static readonly BindableProperty DropDownBorderColorProperty

DropDownBorderThicknessProperty

BindableProperty

Identifies the DropDownBorderThickness bindable property.

public static readonly BindableProperty DropDownBorderThicknessProperty

DropDownContentPaddingProperty

BindableProperty

Identifies the DropDownContentPadding bindable property.

public static readonly BindableProperty DropDownContentPaddingProperty

DropDownContentProperty

BindableProperty

Identifies the DropDownContent bindable property.

public static readonly BindableProperty DropDownContentProperty

DropDownContentTemplateProperty

BindableProperty

Identifies the DropDownContentTemplate bindable property.

public static readonly BindableProperty DropDownContentTemplateProperty

DropDownCornerRadiusProperty

BindableProperty

Identifies the DropDownCornerRadius bindable property.

public static readonly BindableProperty DropDownCornerRadiusProperty

DropDownHeightProperty

BindableProperty

Identifies the DropDownHeight bindable property.

public static readonly BindableProperty DropDownHeightProperty

DropDownHorizontalOffsetProperty

BindableProperty

Identifies the DropDownHorizontalOffset bindable property.

public static readonly BindableProperty DropDownHorizontalOffsetProperty

DropDownIndicatorPositionProperty

BindableProperty

Identifies the DropDownIndicatorPosition bindable property.

public static readonly BindableProperty DropDownIndicatorPositionProperty

DropDownIndicatorStyleProperty

BindableProperty

Identifies the DropDownIndicatorStyle bindable property.

public static readonly BindableProperty DropDownIndicatorStyleProperty

DropDownMaxHeightProperty

BindableProperty

Identifies the DropDownMaxHeight bindable property.

public static readonly BindableProperty DropDownMaxHeightProperty

DropDownMaxWidthProperty

BindableProperty

Identifies the DropDownMaxWidth bindable property.

public static readonly BindableProperty DropDownMaxWidthProperty

DropDownMinHeightProperty

BindableProperty

Identifies the DropDownMinHeight bindable property.

public static readonly BindableProperty DropDownMinHeightProperty

DropDownMinWidthProperty

BindableProperty

Identifies the DropDownMinWidth bindable property.

public static readonly BindableProperty DropDownMinWidthProperty

DropDownPlacementProperty

BindableProperty

Identifies the DropDownPlacement bindable property.

public static readonly BindableProperty DropDownPlacementProperty

DropDownVerticalOffsetProperty

BindableProperty

Identifies the DropDownVerticalOffset bindable property.

public static readonly BindableProperty DropDownVerticalOffsetProperty

DropDownWidthProperty

BindableProperty

Identifies the DropDownWidth bindable property.

public static readonly BindableProperty DropDownWidthProperty

IsDropDownIndicatorVisibleProperty

BindableProperty

Identifies the IsDropDownIndicatorVisible bindable property.

public static readonly BindableProperty IsDropDownIndicatorVisibleProperty

IsOpenProperty

BindableProperty

Identifies the IsOpen bindable property.

public static readonly BindableProperty IsOpenProperty

Properties

ActualDropDownIndicatorStyle

Style

Gets the actual style applied to the drop-down indicator, combining user-defined and default styles.

public Style ActualDropDownIndicatorStyle { get; }

AutoOpenDelay

TimeSpan

Gets or sets the delay before the drop-down automatically opens when the pointer hovers over the button. A value of Zero disables the auto-open behavior. This feature is only applicable on desktop platforms (Windows and macOS).

public TimeSpan AutoOpenDelay { get; set; }

DropDownAnimation

PopupAnimationType

Gets or sets the animation of the drop-down relative to the button.

public PopupAnimationType DropDownAnimation { get; set; }

DropDownAnimationDuration

int

Gets or sets the duration in milliseconds for the drop-down open and close animations. This value is used for both opening and closing animations when AnimationType is not None.

public int DropDownAnimationDuration { get; set; }

Property Value:

The animation duration in milliseconds.

DropDownAnimationEasing

Easing

Gets or sets the easing function used for drop-down opening and closing animations. This determines the acceleration curve for the animation when AnimationType is not None.

[TypeConverter(typeof(EasingTypeConverter))]
public Easing DropDownAnimationEasing { get; set; }

Property Value:

The Easing function for animations. The default value is .

DropDownBackgroundColor

Color

Gets or sets the background color of the drop-down.

public Color DropDownBackgroundColor { get; set; }

DropDownBorderColor

Color

Gets or sets the border color of the drop-down.

public Color DropDownBorderColor { get; set; }

DropDownBorderThickness

Thickness

Gets or sets the border thickness of the drop-down.

public Thickness DropDownBorderThickness { get; set; }

DropDownContent

View

Gets or sets the content displayed inside the drop-down.

public View DropDownContent { get; set; }

DropDownContentPadding

Thickness

Gets or sets the padding of the drop-down content.

public Thickness DropDownContentPadding { get; set; }

DropDownContentTemplate

DataTemplate

Gets or sets the DataTemplate used to display the drop-down content.

public DataTemplate DropDownContentTemplate { get; set; }

DropDownCornerRadius

Thickness

Gets or sets the corner radius of the drop-down.

public Thickness DropDownCornerRadius { get; set; }

DropDownHeight

double

Gets or sets the height of the drop-down.

public double DropDownHeight { get; set; }

DropDownHorizontalOffset

double

Gets or sets the horizontal offset of the drop-down relative to the button.

public double DropDownHorizontalOffset { get; set; }

DropDownIndicatorPosition

DropDownButtonIndicatorPosition

Gets or sets the position of the drop-down indicator relative to the button content.

public DropDownButtonIndicatorPosition DropDownIndicatorPosition { get; set; }

DropDownIndicatorStyle

Style

Gets or sets the style applied to the drop-down indicator. The target type of the style is .

public Style DropDownIndicatorStyle { get; set; }

DropDownMaxHeight

double

Gets or sets the maximum height of the drop-down.

public double DropDownMaxHeight { get; set; }

DropDownMaxWidth

double

Gets or sets the maximum width of the drop-down.

public double DropDownMaxWidth { get; set; }

DropDownMinHeight

double

Gets or sets the minimum height of the drop-down.

public double DropDownMinHeight { get; set; }

DropDownMinWidth

double

Gets or sets the minimum width of the drop-down.

public double DropDownMinWidth { get; set; }

DropDownPlacement

PlacementMode

Gets or sets the placement position of the drop-down relative to the button.

public PlacementMode DropDownPlacement { get; set; }

DropDownVerticalOffset

double

Gets or sets the vertical offset of the drop-down relative to the button.

public double DropDownVerticalOffset { get; set; }

DropDownWidth

double

Gets or sets the width of the drop-down. When not explicitly set, the drop-down width fits its content.

public double DropDownWidth { get; set; }

IsDropDownIndicatorVisible

bool

Gets or sets a value indicating whether the drop-down indicator is visible.

public bool IsDropDownIndicatorVisible { get; set; }

IsOpen

bool

Gets or sets a value indicating whether the drop-down is open.

public bool IsOpen { get; set; }

Methods

ChangeVisualState()

protected override void ChangeVisualState()

Overrides: RadButtonBase.ChangeVisualState()

OnApplyTemplate()

protected override void OnApplyTemplate()

Overrides: RadButtonBase.OnApplyTemplate()

Events

Closed

EventHandler

Raised when the drop-down has fully closed, including the completion of any close animation.

public event EventHandler Closed

Opened

EventHandler

Raised when the drop-down has fully opened, including the completion of any open animation.

public event EventHandler Opened

Opening

EventHandler<CancelEventArgs>

Raised when the IsOpen property is changing to true. Set Cancel to true to prevent the drop-down from opening.

public event EventHandler<CancelEventArgs> Opening