Class
RadPickerBase

A base class for all pickers.

Definition

Namespace:Telerik.Maui.Controls

Assembly:Telerik.Maui.Controls.dll

Syntax:

cs-api-definition
public abstract class RadPickerBase : PickerContentView, IRadContentView, IContentView, IView, IElement, ITransform, IPadding, ICrossPlatformLayout

Inheritance: objectRadContentViewPickerContentViewRadPickerBase

Derived Classes: RadListPickerRadMultiSpinnerPickerBaseRadTemplatedPicker

Implements: IContentViewICrossPlatformLayoutIElementIPaddingIRadContentViewITransformIView

Inherited Members PickerContentView.BackgroundColorPropertyPickerContentView.BorderColorPropertyPickerContentView.BorderThicknessPropertyPickerContentView.CornerRadiusPropertyPickerContentView.BackgroundColorPickerContentView.BorderColorPickerContentView.BorderThicknessPickerContentView.CornerRadiusRadContentView.ActualStyleClassPropertyRadContentView.OnChildAdded(Element)RadContentView.OnChildRemoved(Element, int)RadContentView.OnBindingContextChanged()

Constructors

RadPickerBase()

Initializes a new instance of the RadPickerBase class.

Declaration

cs-api-definition
protected RadPickerBase()

Fields

ActualClearButtonStyleProperty

Identifies the ActualClearButtonStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ActualClearButtonStyleProperty

Field Value

BindableProperty

ActualDisplayLabelStyleProperty

Identifies the ActualDisplayLabelStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ActualDisplayLabelStyleProperty

Field Value

BindableProperty

ActualPlaceholderLabelStyleProperty

Identifies the ActualPlaceholderLabelStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ActualPlaceholderLabelStyleProperty

Field Value

BindableProperty

ActualToggleButtonStyleProperty

Identifies the ActualToggleButtonStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ActualToggleButtonStyleProperty

Field Value

BindableProperty

BorderBrushProperty

Identifies the BorderBrush property.

Declaration

cs-api-definition
public static readonly BindableProperty BorderBrushProperty

Field Value

BindableProperty

ClearButtonStyleProperty

Identifies the ClearButtonStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ClearButtonStyleProperty

Field Value

BindableProperty

DisplayLabelStyleProperty

Identifies the DisplayLabelStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty DisplayLabelStyleProperty

Field Value

BindableProperty

DisplayStringFormatProperty

Identifies the DisplayStringFormat property.

Declaration

cs-api-definition
public static readonly BindableProperty DisplayStringFormatProperty

Field Value

BindableProperty

DisplayStringProperty

Identifies the DisplayString property.

Declaration

cs-api-definition
public static readonly BindableProperty DisplayStringProperty

Field Value

BindableProperty

DisplayTemplateProperty

Identifies the DisplayTemplate property.

Declaration

cs-api-definition
public static readonly BindableProperty DisplayTemplateProperty

Field Value

BindableProperty

DropDownSettingsProperty

Identifies the DropDownSettings property.

Declaration

cs-api-definition
public static readonly BindableProperty DropDownSettingsProperty

Field Value

BindableProperty

IsClearButtonVisibleProperty

Identifies the IsClearButtonVisible property.

Declaration

cs-api-definition
public static readonly BindableProperty IsClearButtonVisibleProperty

Field Value

BindableProperty

IsOpenProperty

Identifies the IsOpen property.

Declaration

cs-api-definition
public static readonly BindableProperty IsOpenProperty

Field Value

BindableProperty

IsPlaceholderVisibleProperty

Identifies the IsPlaceholderVisible property.

Declaration

cs-api-definition
public static readonly BindableProperty IsPlaceholderVisibleProperty

Field Value

BindableProperty

IsToggleButtonVisibleProperty

Identifies the IsToggleButtonVisible property.

Declaration

cs-api-definition
public static readonly BindableProperty IsToggleButtonVisibleProperty

Field Value

BindableProperty

PickerModeProperty

Identifies the PickerMode property.

Declaration

cs-api-definition
public static readonly BindableProperty PickerModeProperty

Field Value

BindableProperty

PlaceholderLabelStyleProperty

Identifies the PlaceholderLabelStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty PlaceholderLabelStyleProperty

Field Value

BindableProperty

PlaceholderProperty

Identifies the Placeholder property.

Declaration

cs-api-definition
public static readonly BindableProperty PlaceholderProperty

Field Value

BindableProperty

PlaceholderTemplateProperty

Identifies the PlaceholderTemplate property.

Declaration

cs-api-definition
public static readonly BindableProperty PlaceholderTemplateProperty

Field Value

BindableProperty

PopupSettingsProperty

Identifies the PopupSettings property.

Declaration

cs-api-definition
public static readonly BindableProperty PopupSettingsProperty

Field Value

BindableProperty

ToggleButtonStyleProperty

Identifies the ToggleButtonStyle property.

Declaration

cs-api-definition
public static readonly BindableProperty ToggleButtonStyleProperty

Field Value

BindableProperty

Properties

ActualClearButtonStyle

Gets the result of merging the default style and the style set as ClearButtonStyle. This is the actual style that is applied to the clear button in the default ControlTemplate.

Declaration

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

Property Value

Style

ActualDisplayLabelStyle

Gets the result of merging the default style and the style set as DisplayLabelStyle. This is the actual style that is applied to the label in the default DisplayTemplate.

Declaration

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

Property Value

Style

ActualPlaceholderLabelStyle

Gets the result of merging the default style and the style set as PlaceholderLabelStyle. This is the actual style that is applied to the label in the default PlaceholderTemplate.

Declaration

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

Property Value

Style

ActualToggleButtonStyle

Gets the result of merging the default style and the style set as ToggleButtonStyle. This is the actual style that is applied to the toggle button in the default ControlTemplate.

Declaration

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

Property Value

Style

BorderBrush

Gets or sets the border Brush of the picker.

Declaration

cs-api-definition
[TypeConverter(typeof(BrushTypeConverter))]
public Brush BorderBrush { get; set; }

Property Value

Brush

ClearButtonStyle

Gets or sets the style that will be applied to the clear button. For more information see the ClearCommand.

Declaration

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

Property Value

Style

ClearCommand

Gets the command which sets the selection to null.

Declaration

cs-api-definition
public ICommand ClearCommand { get; }

Property Value

ICommand

DisplayLabelStyle

Gets or sets the style that will be applied to the label used to visualize the selection.

Declaration

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

Property Value

Style

DisplayString

Gets the result of applying the DisplayStringFormat on the current selection.

Declaration

cs-api-definition
public string DisplayString { get; }

Property Value

string

DisplayStringFormat

Gets or sets the format string that is to be applied to the current selection.

Declaration

cs-api-definition
public string DisplayStringFormat { get; set; }

Property Value

string

DisplayTemplate

Gets or sets the template which will visualize the current selection.

Declaration

cs-api-definition
public ControlTemplate DisplayTemplate { get; set; }

Property Value

ControlTemplate

DropDownSettings

Gets or sets the settings that should be applied when the picker is in a drop-down mode. When DropDownSettings are set, the PickerMode property should be set to DropDown. For more information see the PickerMode property.

Declaration

cs-api-definition
public PickerDropDownSettings DropDownSettings { get; set; }

Property Value

PickerDropDownSettings

IsClearButtonVisible

Gets or sets a value indicating whether the clear button is visible.

Declaration

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

Property Value

bool

IsOpen

Gets a value indicating whether the selector (popup or dropdown) is toggled.

Declaration

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

Property Value

bool

IsPlaceholderVisible

Gets a value indicating whether the placeholder is currently visible in the picker.

Declaration

cs-api-definition
public bool IsPlaceholderVisible { get; }

Property Value

bool

IsToggleButtonVisible

Gets or sets a value indicating whether the toggle button is visible.

Declaration

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

Property Value

bool

PickerMode

Gets or sets the currently active mode of the picker. For more information see the PickerMode type.

Declaration

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

Property Value

PickerMode

Placeholder

Gets or sets the object to be displayed when there is no selection.

Declaration

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

Property Value

object

PlaceholderLabelStyle

Gets or sets the style to be applied to the label defined in the default PlaceholderTemplate.

Declaration

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

Property Value

Style

PlaceholderTemplate

Gets or sets the ControlTemplate which is to be displayed when no selection is available.

Declaration

cs-api-definition
public ControlTemplate PlaceholderTemplate { get; set; }

Property Value

ControlTemplate

PopupSettings

Gets or sets the settings that should be applied when the picker is in a popup mode. When PopupSettings are set, the PickerMode property should be set to Popup. For more information see the PickerMode property.

Declaration

cs-api-definition
public PickerPopupSettings PopupSettings { get; set; }

Property Value

PickerPopupSettings

ToggleButtonStyle

Gets or sets the style that will be applied to the toggle button. For more information see the ToggleCommand.

Declaration

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

Property Value

Style

ToggleCommand

Gets the command which visualizes and hides the selector.

Declaration

cs-api-definition
public ICommand ToggleCommand { get; }

Property Value

ICommand

Methods

ClearSelection()

Clears the current selection in the picker, setting it to null.

Declaration

cs-api-definition
public void ClearSelection()

OnHandlerChanged()

Called when the handler for this picker changes. Initializes visual states and sets up platform-specific configurations.

Declaration

cs-api-definition
protected override void OnHandlerChanged()

Overrides RadContentView.OnHandlerChanged()

Remarks

This method performs the following platform-specific operations:

  • On Android: Sets the platform view as focusable in touch mode.
  • On iOS/Mac Catalyst: Manages the PickerBaseFocusableView proxy connections.

OnPropertyChanged(string)

Declaration

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

Parameters

propertyName

string

Events

SelectionChanged

Occurs when the selection in the picker changes.

Declaration

cs-api-definition
public event EventHandler SelectionChanged

Event Value

EventHandler