Class
RadDropDownButton

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:

cs-api-definition
public class RadDropDownButton : RadTemplatedButton, INotifyPropertyChanged

Inheritance: objectRadButtonBaseRadTemplatedButtonRadDropDownButton

Implements: INotifyPropertyChanged

Inherited Members RadTemplatedButton.ContentPropertyRadTemplatedButton.ContentTemplatePropertyRadTemplatedButton.TextColorPropertyRadTemplatedButton.FontFamilyPropertyRadTemplatedButton.FontSizePropertyRadTemplatedButton.FontAttributesPropertyRadTemplatedButton.TextDecorationsPropertyRadTemplatedButton.HorizontalTextAlignmentPropertyRadTemplatedButton.VerticalTextAlignmentPropertyRadTemplatedButton.ActualContentPropertyRadTemplatedButton.ContentRadTemplatedButton.ContentTemplateRadTemplatedButton.TextColorRadTemplatedButton.FontFamilyRadTemplatedButton.FontSizeRadTemplatedButton.FontAttributesRadTemplatedButton.TextDecorationsRadTemplatedButton.HorizontalTextAlignmentRadTemplatedButton.VerticalTextAlignmentRadTemplatedButton.ActualContentRadButtonBase.IsPressedPropertyRadButtonBase.CommandPropertyRadButtonBase.CommandParameterPropertyRadButtonBase.StylePropertyRadButtonBase.ControlTemplatePropertyRadButtonBase.BackgroundColorPropertyRadButtonBase.BackgroundPropertyRadButtonBase.PaddingPropertyRadButtonBase.BorderColorPropertyRadButtonBase.BorderBrushPropertyRadButtonBase.BorderThicknessPropertyRadButtonBase.CornerRadiusPropertyRadButtonBase.OnHandlerChanging(HandlerChangingEventArgs)RadButtonBase.OnHandlerChanged()RadButtonBase.ChangeVisualState()RadButtonBase.IsPressedRadButtonBase.CommandRadButtonBase.CommandParameterRadButtonBase.StyleRadButtonBase.ControlTemplateRadButtonBase.BackgroundColorRadButtonBase.BackgroundRadButtonBase.PaddingRadButtonBase.BorderColorRadButtonBase.BorderBrushRadButtonBase.BorderThicknessRadButtonBase.CornerRadiusRadButtonBase.IsEnabledCoreRadButtonBase.ClickedRadButtonBase.PressedRadButtonBase.Released

Constructors

RadDropDownButton()

Initializes a new instance of the RadDropDownButton class.

Declaration

cs-api-definition
public RadDropDownButton()

Fields

ActualDropDownIndicatorStyleProperty

Identifies the ActualDropDownIndicatorStyle bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty ActualDropDownIndicatorStyleProperty

Field Value

BindableProperty

AutoOpenDelayProperty

Identifies the AutoOpenDelay bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty AutoOpenDelayProperty

Field Value

BindableProperty

DropDownBackgroundColorProperty

Identifies the DropDownBackgroundColor bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownBackgroundColorProperty

Field Value

BindableProperty

DropDownBorderColorProperty

Identifies the DropDownBorderColor bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownBorderColorProperty

Field Value

BindableProperty

DropDownBorderThicknessProperty

Identifies the DropDownBorderThickness bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownBorderThicknessProperty

Field Value

BindableProperty

DropDownContentPaddingProperty

Identifies the DropDownContentPadding bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownContentPaddingProperty

Field Value

BindableProperty

DropDownContentProperty

Identifies the DropDownContent bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownContentProperty

Field Value

BindableProperty

DropDownContentTemplateProperty

Identifies the DropDownContentTemplate bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownContentTemplateProperty

Field Value

BindableProperty

DropDownCornerRadiusProperty

Identifies the DropDownCornerRadius bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownCornerRadiusProperty

Field Value

BindableProperty

DropDownHeightProperty

Identifies the DropDownHeight bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownHeightProperty

Field Value

BindableProperty

DropDownHorizontalOffsetProperty

Identifies the DropDownHorizontalOffset bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownHorizontalOffsetProperty

Field Value

BindableProperty

DropDownIndicatorPositionProperty

Identifies the DropDownIndicatorPosition bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownIndicatorPositionProperty

Field Value

BindableProperty

DropDownIndicatorStyleProperty

Identifies the DropDownIndicatorStyle bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownIndicatorStyleProperty

Field Value

BindableProperty

DropDownMaxHeightProperty

Identifies the DropDownMaxHeight bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownMaxHeightProperty

Field Value

BindableProperty

DropDownMaxWidthProperty

Identifies the DropDownMaxWidth bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownMaxWidthProperty

Field Value

BindableProperty

DropDownMinHeightProperty

Identifies the DropDownMinHeight bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownMinHeightProperty

Field Value

BindableProperty

DropDownMinWidthProperty

Identifies the DropDownMinWidth bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownMinWidthProperty

Field Value

BindableProperty

DropDownPositionProperty

Identifies the DropDownPosition bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownPositionProperty

Field Value

BindableProperty

DropDownVerticalOffsetProperty

Identifies the DropDownVerticalOffset bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownVerticalOffsetProperty

Field Value

BindableProperty

DropDownWidthProperty

Identifies the DropDownWidth bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownWidthProperty

Field Value

BindableProperty

IsDropDownIndicatorVisibleProperty

Identifies the IsDropDownIndicatorVisible bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty IsDropDownIndicatorVisibleProperty

Field Value

BindableProperty

IsDropDownOpenProperty

Identifies the IsDropDownOpen bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty IsDropDownOpenProperty

Field Value

BindableProperty

Properties

ActualDropDownIndicatorStyle

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

Declaration

cs-api-definition
public Style ActualDropDownIndicatorStyle { get; }

Property Value

Style

AutoOpenDelay

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).

Declaration

cs-api-definition
public TimeSpan AutoOpenDelay { get; set; }

Property Value

TimeSpan

DropDownBackgroundColor

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

Declaration

cs-api-definition
public Color DropDownBackgroundColor { get; set; }

Property Value

Color

DropDownBorderColor

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

Declaration

cs-api-definition
public Color DropDownBorderColor { get; set; }

Property Value

Color

DropDownBorderThickness

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

Declaration

cs-api-definition
public Thickness DropDownBorderThickness { get; set; }

Property Value

Thickness

DropDownContent

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

Declaration

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

Property Value

object

DropDownContentPadding

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

Declaration

cs-api-definition
public Thickness DropDownContentPadding { get; set; }

Property Value

Thickness

DropDownContentTemplate

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

Declaration

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

Property Value

DataTemplate

DropDownCornerRadius

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

Declaration

cs-api-definition
public Thickness DropDownCornerRadius { get; set; }

Property Value

Thickness

DropDownHeight

Gets or sets the height of the drop-down.

Declaration

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

Property Value

double

DropDownHorizontalOffset

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

Declaration

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

Property Value

double

DropDownIndicatorPosition

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

Declaration

cs-api-definition
public DropDownButtonIndicatorPosition DropDownIndicatorPosition { get; set; }

Property Value

DropDownButtonIndicatorPosition

DropDownIndicatorStyle

Gets or sets the style applied to the drop-down indicator.

Declaration

cs-api-definition
public Style DropDownIndicatorStyle { get; set; }

Property Value

Style

DropDownMaxHeight

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

Declaration

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

Property Value

double

DropDownMaxWidth

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

Declaration

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

Property Value

double

DropDownMinHeight

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

Declaration

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

Property Value

double

DropDownMinWidth

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

Declaration

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

Property Value

double

DropDownPosition

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

Declaration

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

Property Value

PlacementMode

DropDownVerticalOffset

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

Declaration

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

Property Value

double

DropDownWidth

Gets or sets the width of the drop-down. If not set, the drop-down width matches the button width.

Declaration

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

Property Value

double

IsDropDownIndicatorVisible

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

Declaration

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

Property Value

bool

IsDropDownOpen

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

Declaration

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

Property Value

bool

Methods

OnApplyTemplate()

Declaration

cs-api-definition
protected override void OnApplyTemplate()

Overrides RadButtonBase.OnApplyTemplate()

OnPropertyChanged(string)

Declaration

cs-api-definition
protected override void OnPropertyChanged(string propertyName = null)

Parameters

propertyName

string

Overrides RadButtonBase.OnPropertyChanged(string)

Events

Opening

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

Declaration

cs-api-definition
public event EventHandler<CancelEventArgs> Opening

Event Value

EventHandler<CancelEventArgs>