menu

MAUI

  • User Guide
  • Demos
  • Support
  • Forums
  • Download

    Show / Hide Table of Contents

    Class DropDownListBase

    Represent a base class which is used to create a list control like SfComboBox or SfAutocomplete. These controls are used to selected item(s) from the suggestions displayed in drop down.

    Inheritance
    System.Object
    SfView
    SfDropdownEntry
    DropDownListBase
    SfAutocomplete
    SfComboBox
    Implements
    IDrawableLayout
    Microsoft.Maui.Graphics.IDrawable
    Microsoft.Maui.IAbsoluteLayout
    Microsoft.Maui.ILayout
    Microsoft.Maui.IView
    Microsoft.Maui.IElement
    Microsoft.Maui.ITransform
    Microsoft.Maui.IContainer
    System.Collections.Generic.IList<Microsoft.Maui.IView>
    System.Collections.Generic.ICollection<Microsoft.Maui.IView>
    System.Collections.Generic.IEnumerable<Microsoft.Maui.IView>
    System.Collections.IEnumerable
    Microsoft.Maui.ISafeAreaView
    Microsoft.Maui.IPadding
    Microsoft.Maui.ICrossPlatformLayout
    Microsoft.Maui.IVisualTreeElement
    Inherited Members
    SfDropdownEntry.ClearButtonIconColor
    SfDropdownEntry.ClearButtonIconColorProperty
    SfDropdownEntry.ClearButtonPath
    SfDropdownEntry.ClearButtonPathProperty
    SfDropdownEntry.CursorPosition
    SfDropdownEntry.CursorPositionProperty
    SfDropdownEntry.DropDownClosing
    SfDropdownEntry.DropdownOpened
    SfDropdownEntry.DropdownOpening
    SfDropdownEntry.Focus()
    SfDropdownEntry.FontAttributes
    SfDropdownEntry.FontAttributesProperty
    SfDropdownEntry.FontAutoScalingEnabled
    SfDropdownEntry.FontAutoScalingEnabledProperty
    SfDropdownEntry.FontFamily
    SfDropdownEntry.FontFamilyProperty
    SfDropdownEntry.FontSize
    SfDropdownEntry.FontSizeProperty
    SfDropdownEntry.IsClearButtonVisible
    SfDropdownEntry.IsClearButtonVisibleProperty
    SfDropdownEntry.IsDropDownOpen
    SfDropdownEntry.IsDropDownOpenProperty
    SfDropdownEntry.MaxDropDownHeight
    SfDropdownEntry.MaxDropDownHeightProperty
    SfDropdownEntry.MeasureContent(Double, Double)
    SfDropdownEntry.OnDraw(ICanvas, RectF)
    SfDropdownEntry.OnDropdownOpening()
    SfDropdownEntry.OnFontChanged(Font, Font)
    SfDropdownEntry.Placeholder
    SfDropdownEntry.PlaceholderColor
    SfDropdownEntry.PlaceholderColorProperty
    SfDropdownEntry.PlaceholderProperty
    SfDropdownEntry.Stroke
    SfDropdownEntry.StrokeProperty
    SfDropdownEntry.TextColor
    SfDropdownEntry.TextColorProperty
    SfDropdownEntry.Unfocus()
    SfView.ArrangeOverride(Rect)
    SfView.Children
    SfView.ClipToBounds
    SfView.GetSemanticsNodesCore(Double, Double)
    SfView.IDrawableLayout.DrawingOrder
    SfView.IDrawableLayout.InvalidateDrawable()
    SfView.MeasureOverride(Double, Double)
    SfView.OnBindingContextChanged()
    SfView.Padding
    Namespace: Syncfusion.Maui.Inputs.DropDownControls
    Assembly: Syncfusion.Maui.Inputs.dll
    Syntax
    public abstract class DropDownListBase : SfDropdownEntry, IDrawableLayout, IDrawable, IAbsoluteLayout, ILayout, IView, IElement, ITransform, IContainer, IList<IView>, ICollection<IView>, IEnumerable<IView>, IEnumerable, ISafeAreaView, IPadding, ICrossPlatformLayout, IVisualTreeElement, ISemanticsProvider, ITouchListener, ITextElement, IKeyboardListener

    Constructors

    DropDownListBase()

    Initializes a new instance of the DropDownListBase class.

    Declaration
    public DropDownListBase()

    Fields

    DelimiterTextProperty

    Identifies DelimiterText bindable property.

    Declaration
    public static readonly BindableProperty DelimiterTextProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DelimiterText bindable property.

    DisplayMemberPathProperty

    Identifies DisplayMemberPath bindable property.

    Declaration
    public static readonly BindableProperty DisplayMemberPathProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DisplayMemberPath bindable property.

    DropDownBackgroundProperty

    Identifies DropDownBackground bindable property.

    Declaration
    public static readonly BindableProperty DropDownBackgroundProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownBackground bindable property.

    DropdownFooterViewHeightProperty

    Identifies DropdownFooterViewHeight bindable property.

    Declaration
    public static readonly BindableProperty DropdownFooterViewHeightProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DropdownFooterViewProperty

    Identifies DropdownFooterView bindable property.

    Declaration
    public static readonly BindableProperty DropdownFooterViewProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DropdownHeaderViewHeightProperty

    Identifies DropdownHeaderViewHeight bindable property.

    Declaration
    public static readonly BindableProperty DropdownHeaderViewHeightProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DropdownHeaderViewProperty

    Identifies DropdownHeaderView bindable property.

    Declaration
    public static readonly BindableProperty DropdownHeaderViewProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DropDownItemFontAttributesProperty

    Identifies DropDownItemFontAttributes bindable property.

    Declaration
    public static readonly BindableProperty DropDownItemFontAttributesProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownItemFontAttributes bindable property.

    DropDownItemFontFamilyProperty

    Identifies DropDownItemFontFamily bindable property.

    Declaration
    public static readonly BindableProperty DropDownItemFontFamilyProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownItemFontFamily bindable property.

    DropDownItemFontSizeProperty

    Identifies DropDownItemFontSize bindable property.

    Declaration
    public static readonly BindableProperty DropDownItemFontSizeProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownItemFontSize bindable property.

    DropDownItemHeightProperty

    Identifies DropDownItemHeight bindable property.

    Declaration
    public static readonly BindableProperty DropDownItemHeightProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownItemHeight bindable property.

    DropDownItemTextColorProperty

    Identifies DropDownItemTextColor bindable property.

    Declaration
    public static readonly BindableProperty DropDownItemTextColorProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownItemTextColor bindable property.

    DropDownPlacementProperty

    Gets or sets the value that can be used to customize the position of the drop-down.

    Declaration
    public static readonly BindableProperty DropDownPlacementProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    DropDownStrokeProperty

    Identifies DropDownStroke bindable property.

    Declaration
    public static readonly BindableProperty DropDownStrokeProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownStroke bindable property.

    DropDownStrokeThicknessProperty

    Identifies DropDownStrokeThickness bindable property.

    Declaration
    public static readonly BindableProperty DropDownStrokeThicknessProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the DropDownStrokeThickness bindable property.

    DropdownWidthProperty

    Identifies DropdownWidth bindable property.

    Declaration
    public static readonly BindableProperty DropdownWidthProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    HighlightedTextColorProperty

    Identifies HighlightedTextColor bindable property.

    Declaration
    public static readonly BindableProperty HighlightedTextColorProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the HighlightedTextColor bindable property.

    HighlightedTextFontAttributesProperty

    Gets or sets the value that can be used to set the font attributes of the MatchingText in the drop-down. Identifies HighlightedTextFontAttributes bindable property.

    Declaration
    public static readonly BindableProperty HighlightedTextFontAttributesProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the HighlightedTextFontAttributes bindable property.

    IsDropDownShadowVisibleProperty

    Identifies the IsDropDownShadowVisible bindable property. This property can be used to indicate whether to show the shadow for the Dropdown or not.

    Declaration
    public static readonly BindableProperty IsDropDownShadowVisibleProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ItemPaddingProperty

    Identifies the ItemPadding bindable property.

    Declaration
    public static readonly BindableProperty ItemPaddingProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ItemsSourceProperty

    Identifies ItemsSource bindable property.

    Declaration
    public static readonly BindableProperty ItemsSourceProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the ItemsSource bindable property.

    ItemTemplateProperty

    Identifies ItemTemplate bindable property.

    Declaration
    public static readonly BindableProperty ItemTemplateProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the ItemTemplate bindable property.

    LoadMoreTemplateProperty

    Identifies the LoadMoreTemplate bindable property. This property can be used to change the LoadMoreTemplate.

    Declaration
    public static readonly BindableProperty LoadMoreTemplateProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    LoadMoreTextProperty

    Identifies the LoadMoreText bindable property. This property can be used to change text of the LoadMore button.

    Declaration
    public static readonly BindableProperty LoadMoreTextProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    MaximumSuggestionProperty

    Identifies the MaximumSuggestion bindable property. This property indicates the minimum number of characters to be typed for the drop-down to open.

    Declaration
    public static readonly BindableProperty MaximumSuggestionProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    MinimumPrefixCharactersProperty

    Identifies MinimumPrefixCharacters bindable property.

    Declaration
    public static readonly BindableProperty MinimumPrefixCharactersProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the MinimumPrefixCharacters bindable property.

    NoResultsFoundTemplateProperty

    Identifies NoResultsFoundTemplate bindable property.

    Declaration
    public static readonly BindableProperty NoResultsFoundTemplateProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    NoResultsFoundTextProperty

    Identifies NoResultsFoundText bindable property.

    Declaration
    public static readonly BindableProperty NoResultsFoundTextProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the NoResultsFoundText bindable property.

    ReturnCommandParameterProperty

    Identifies the ReturnCommandParameter bindable property. ReturnCommandParameter is a type of object and it specifies the parameter for the ReturnCommand.

    Declaration
    public static readonly BindableProperty ReturnCommandParameterProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the ReturnCommandParameter bindable property.

    ReturnCommandProperty

    Identifies the ReturnCommand bindable property.The return command will trigger whenever the return key is pressed. The default value is null.

    Declaration
    public static readonly BindableProperty ReturnCommandProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the ReturnCommand bindable property.

    ReturnTypeProperty

    Identifies the ReturnType bindable property. This property can be used to change the ReturnType.

    Declaration
    public static readonly BindableProperty ReturnTypeProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    SelectedDropDownItemBackgroundProperty

    Identifies SelectedDropDownItemBackground bindable property.

    Declaration
    public static readonly BindableProperty SelectedDropDownItemBackgroundProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectedDropDownItemBackground bindable property.

    SelectedItemProperty

    Identifies SelectedItem bindable property.

    Declaration
    public static readonly BindableProperty SelectedItemProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectedItem bindable property.

    SelectedItemsProperty

    Identifies SelectedItems bindable property.

    Declaration
    public static readonly BindableProperty SelectedItemsProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectedItems bindable property.

    SelectedValuePathProperty

    Identifies SelectedValuePath bindable property.

    Declaration
    public static readonly BindableProperty SelectedValuePathProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectedValuePath bindable property.

    SelectedValueProperty

    Identifies SelectedValue bindable property.

    Declaration
    public static readonly BindableProperty SelectedValueProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectedValue bindable property.

    SelectionTextHighlightColorProperty

    Identifies SelectionTextHighlightColor bindable property.

    Declaration
    public static readonly BindableProperty SelectionTextHighlightColorProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the SelectionTextHighlightColor bindable property.

    ShowDropdownFooterViewProperty

    Identifies ShowDropdownFooterView bindable property.

    Declaration
    public static readonly BindableProperty ShowDropdownFooterViewProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ShowDropdownHeaderViewProperty

    Identifies ShowDropdownHeaderView bindable property.

    Declaration
    public static readonly BindableProperty ShowDropdownHeaderViewProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    ShowSuggestionsOnFocusProperty

    Identifies ShowSuggestionsOnFocus bindable property.

    Declaration
    public static readonly BindableProperty ShowSuggestionsOnFocusProperty
    Field Value
    Type
    Microsoft.Maui.Controls.BindableProperty

    TextHighlightModeProperty

    Identifies TextHighlightMode bindable property.

    Declaration
    public static readonly BindableProperty TextHighlightModeProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the TextHighlightMode bindable property.

    TextMemberPathProperty

    Identifies TextMemberPath bindable property.

    Declaration
    public static readonly BindableProperty TextMemberPathProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the TextMemberPath bindable property.

    TextProperty

    Identifies Text bindable property.

    Declaration
    public static readonly BindableProperty TextProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the Text bindable property.

    TokenItemStyleProperty

    Identifies TokenItemStyle dependency property.

    Declaration
    public static readonly BindableProperty TokenItemStyleProperty
    Field Value
    Type Description
    Microsoft.Maui.Controls.BindableProperty

    The identifier for the TokenItemStyle dependency property.

    Properties

    DelimiterText

    Gets or sets a string as delimiter which is displayed between the selected items in multiple selection mode.

    Declaration
    public string DelimiterText { get; set; }
    Property Value
    Type
    System.String

    DisplayMemberPath

    Gets or sets the name or path of the property that is displayed for each data item in the drop down.

    Declaration
    public string DisplayMemberPath { get; set; }
    Property Value
    Type Description
    System.String

    The default value is string.Empty.

    Remarks

    In non-editable mode, search will be performed using DisplayMemberPath when the popup is opened. If TextMemberPath is null or string.Empty, then searching and displaying the selected value in selection box area will be based on DisplayMemberPath. If both TextMemberPath and DisplayMemberPath properties are null or string.Empty, then searching and displaying the selected value will be based on value received from object.ToString.

    DropDownBackground

    Gets or sets the background color that is used to display in the drop down.

    Declaration
    public Brush DropDownBackground { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Brush

    The default value is null.

    DropdownFooterView

    Gets or sets the value that can be used to customize the footer of the drop-down.

    Declaration
    public View DropdownFooterView { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.View

    The default value is null.

    DropdownFooterViewHeight

    Gets or sets the value that can be used to customize the height of the drop-down footer view.

    Declaration
    public double DropdownFooterViewHeight { get; set; }
    Property Value
    Type Description
    System.Double

    It accepts double value, and the default value is 30.

    DropdownHeaderView

    Gets or sets the value that can be used to customize the header of the drop-down.

    Declaration
    public View DropdownHeaderView { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.View

    The default value is null.

    DropdownHeaderViewHeight

    Gets or sets the value that can be used to customize the height of the drop-down header view.

    Declaration
    public double DropdownHeaderViewHeight { get; set; }
    Property Value
    Type Description
    System.Double

    It accepts double value, and the default value is 30.

    DropDownItemFontAttributes

    Gets or sets the font attributes that is used to display in the drop down text.

    Declaration
    public FontAttributes DropDownItemFontAttributes { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.FontAttributes

    The default value is FontAttributes.None.

    DropDownItemFontFamily

    Gets or sets the font family that is used to display in the drop down text.

    Declaration
    public string DropDownItemFontFamily { get; set; }
    Property Value
    Type Description
    System.String

    The default value is null.

    DropDownItemFontSize

    Gets or sets the font size that is used to display in the drop down text.

    Declaration
    public double DropDownItemFontSize { get; set; }
    Property Value
    Type Description
    System.Double

    The default value is 14d.

    DropDownItemHeight

    Gets or sets the item height that is used to display in the drop down item.

    Declaration
    public double DropDownItemHeight { get; set; }
    Property Value
    Type Description
    System.Double

    The default value is if Windows or Maccatalyst 36 else 48.

    DropDownItemTextColor

    Gets or sets the text color that is used to display in the drop down text.

    Declaration
    public Color DropDownItemTextColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The default value is Colors.Black.

    DropDownPlacement

    Gets or sets the value that can be used to customize the position of the drop-down.

    Declaration
    public DropDownPlacement DropDownPlacement { get; set; }
    Property Value
    Type Description
    DropDownPlacement

    It accepts DropDownPlacement value, and the default value is Bottom.

    DropDownStroke

    Gets or sets the stroke color that is used to display in the drop down view.

    Declaration
    public Brush DropDownStroke { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Brush

    The default value is Color.FromRgb(220, 220, 220) .

    DropDownStrokeThickness

    Gets or sets the stroke thickness that is used to display in the drop down view.

    Declaration
    public Thickness DropDownStrokeThickness { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Thickness

    The default value is if Windows or Maccatalyst new Thickness(1) else new Thickneess(0) .

    DropdownWidth

    Gets or sets the value that can be used to customize the width of the drop-down.

    Declaration
    public double DropdownWidth { get; set; }
    Property Value
    Type
    System.Double

    HighlightedTextColor

    Gets or sets the value that can change the highlighted character's text color. 

    Declaration
    public Color HighlightedTextColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    It accepts Color value, and the default value is Blue.

    HighlightedTextFontAttributes

    Gets or sets the value that can be used to set the font attributes of the MatchingText in the drop-down. 

    Declaration
    public FontAttributes HighlightedTextFontAttributes { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.FontAttributes

    It accepts FontAttributes value, and the default value is None.

    IsDropDownShadowVisible

    Gets or sets the value that indicates whether to show the shadow for Dropdown or not.

    Declaration
    public bool IsDropDownShadowVisible { get; set; }
    Property Value
    Type
    System.Boolean

    ItemPadding

    Gets or sets a value that can be used to change padding between items in SfComboBox.

    Declaration
    public Thickness ItemPadding { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Thickness

    The default value is (10,0,0,0).

    ItemsSource

    Gets or sets an object source used to generate the content of the control.

    Declaration
    public object ItemsSource { get; set; }
    Property Value
    Type Description
    System.Object

    The default value is null.

    ItemTemplate

    Gets or sets the data template for dropdown item in dropdown view.

    Declaration
    public DataTemplate ItemTemplate { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.DataTemplate

    The default value is null.

    LoadMoreTemplate

    Gets or sets the value of LoadMoreTemplate. This property can be used to set the LoadMoreTemplate.

    Declaration
    public DataTemplate LoadMoreTemplate { get; set; }
    Property Value
    Type
    Microsoft.Maui.Controls.DataTemplate

    LoadMoreText

    Gets or sets the vaule of LoadMoreText. This property can be used to set the text of LoadMore button.

    Declaration
    public string LoadMoreText { get; set; }
    Property Value
    Type
    System.String

    MaximumSuggestion

    Gets or sets the vaule of MaximumSuggestion. This property sets the initial and dynamically loading items count in LoadMore.

    Declaration
    public int MaximumSuggestion { get; set; }
    Property Value
    Type
    System.Int32

    MinimumPrefixCharacters

    Gets or sets the value of MinimumPrefixCharacters. It determines minimum number of characters to be typed for the drop-down to open.

    Declaration
    public int MinimumPrefixCharacters { get; set; }
    Property Value
    Type
    System.Int32

    NoResultsFoundTemplate

    Gets or sets the DataTemplate used to display in the dropdown when no results are found in the search.

    Declaration
    public DataTemplate NoResultsFoundTemplate { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.DataTemplate

    The default value is null.

    NoResultsFoundText

    Gets or sets the text to display when no results are found.

    Declaration
    public string NoResultsFoundText { get; set; }
    Property Value
    Type Description
    System.String

    The default value is No Results Found.

    ReturnCommand

    Gets or sets the Returncommand to run when the user presses the return key, either physically or on the on-screen keyboard.

    Declaration
    public ICommand ReturnCommand { get; set; }
    Property Value
    Type Description
    System.Windows.Input.ICommand

    Specifies the Returncommand. The default value is null.

    ReturnCommandParameter

    Gets or sets the parameter object for the ReturnCommand that can be used to provide extra information.

    Declaration
    public object ReturnCommandParameter { get; set; }
    Property Value
    Type Description
    System.Object

    Specifies the ReturncommandParameter. The default value in null

    ReturnType

    Gets or sets the value of ReturnType. This property can be used to set the ReturnType.

    Declaration
    public ReturnType ReturnType { get; set; }
    Property Value
    Type
    Microsoft.Maui.ReturnType

    SelectedDropDownItemBackground

    Gets or sets the selection background color that is used to display in the drop down item selected background.

    Declaration
    public Brush SelectedDropDownItemBackground { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Brush

    The default value is null .

    SelectedItem

    Gets or sets the selected item.

    Declaration
    public object SelectedItem { get; set; }
    Property Value
    Type Description
    System.Object

    The default value is null.

    Remarks

    Editor will show PlaceHolderText when no item is selected.

    SelectedItems

    Gets or sets selected Items

    Declaration
    public IList SelectedItems { get; set; }
    Property Value
    Type Description
    System.Collections.IList

    The default value is null.

    SelectedValue

    Gets the value of the SelectedItem obtained using SelectedValuePath.

    Declaration
    public object SelectedValue { get; set; }
    Property Value
    Type Description
    System.Object

    The default value is null.

    Remarks

    The value of the selected item.

    SelectedValuePath

    Gets or sets the property path that is used to get the SelectedValue property of the SelectedItem property.

    Declaration
    public string SelectedValuePath { get; set; }
    Property Value
    Type Description
    System.String

    The default value is string.Empty.

    Remarks

    If SelectedValuePath is null, SelectedValue will be received from object.ToString.

    SelectionTextHighlightColor

    Gets or sets the selection color that is used to display in the input view text background.

    Declaration
    public Color SelectionTextHighlightColor { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Graphics.Color

    The default value is if Windows Color.FromRgba("#0078d7") else if Android Color.FromRgba("#AA9DD6") else Color.FromRgba("#aed5fa") .

    ShowDropdownFooterView

    Gets or sets a value that indicates whether the drop-down footer view is shown or not.

    Declaration
    public bool ShowDropdownFooterView { get; set; }
    Property Value
    Type Description
    System.Boolean

    It accepts boolean value and the default value is false.

    ShowDropdownHeaderView

    Gets or sets a value that indicates whether the drop-down header view is shown or not.

    Declaration
    public bool ShowDropdownHeaderView { get; set; }
    Property Value
    Type Description
    System.Boolean

    It accepts boolean value and the default value is false.

    ShowSuggestionsOnFocus

    Gets or sets a value indicating whether the complete suggestion list should be displayed when an empty input field is focused.

    Declaration
    public bool ShowSuggestionsOnFocus { get; set; }
    Property Value
    Type Description
    System.Boolean

    It accepts boolean value and the default value is false.

    Text

    Gets the text that is used to display in the text box portion of the control.

    Declaration
    public string Text { get; set; }
    Property Value
    Type Description
    System.String

    The default value is string.Empty.

    Remarks

    This property does not have effect in non-editable mode.

    TextHighlightMode

    Gets or sets the value that can be used to highlight whether the first character or all the same characters in the text.  

    Declaration
    public OccurrenceMode TextHighlightMode { get; set; }
    Property Value
    Type Description
    OccurrenceMode

    It accepts OccurrenceMode  value, and the default value is None.

    TextMemberPath

    Gets or sets the property path that is used to display the selected value in the text box portion or non-editable display area.

    Declaration
    public string TextMemberPath { get; set; }
    Property Value
    Type Description
    System.String

    The default value is string.Empty.

    Remarks

    In editable mode, search will be performed using TextMemberPath. In non-editable mode, search will be performed using TextMemberPath when the popup is not opened. In non-editable mode, search will be performed using DisplayMemberPath when the popup is opened. If TextMemberPath is null or string.Empty, then searching and displaying the selected value in selection box area will be based on DisplayMemberPath. If both TextMemberPath and DisplayMemberPath properties are null or string.Empty, then searching and displaying the selected value will be based on value received from object.ToString.

    TokenItemStyle

    Gets or sets the Style that is used to display the token items.

    Declaration
    public Style TokenItemStyle { get; set; }
    Property Value
    Type Description
    Microsoft.Maui.Controls.Style

    The default value is null.

    Remarks

    It applicable for multi-selection token mode only.

    Methods

    ArrangeContent(Rect)

    Arrange Content method.

    Declaration
    protected override Size ArrangeContent(Rect bounds)
    Parameters
    Type Name Description
    Microsoft.Maui.Graphics.Rect bounds
    Returns
    Type
    Microsoft.Maui.Graphics.Size
    Overrides
    SfDropdownEntry.ArrangeContent(Rect)

    Clear()

    Clear all the values in SelectedItem and InputView.Text

    Declaration
    public void Clear()

    Finalize()

    Destructor of the DropDownListBase class.

    Declaration
    protected override void Finalize()
    Overrides
    SfDropdownEntry.Finalize()

    OnHandlerChanged()

    Handler changed method.

    Declaration
    protected override void OnHandlerChanged()
    Overrides
    SfDropdownEntry.OnHandlerChanged()

    OnPropertyChanged(String)

    PropertyChanged method.

    Declaration
    protected override void OnPropertyChanged(string propertyName = null)
    Parameters
    Type Name Description
    System.String propertyName

    OnSizeAllocated(Double, Double)

    Invoked when the size of the view is allocated.

    Declaration
    protected override void OnSizeAllocated(double width, double height)
    Parameters
    Type Name Description
    System.Double width

    The allocated width.

    System.Double height

    The allocated height.

    Events

    Completed

    The completed event gets raised when pressing enter key or return key after the text is entered in the input field. It is applicable only for editable modes.

    Declaration
    public event EventHandler Completed
    Event Type
    Type
    System.EventHandler

    DropDownClosed

    Occurs when the dropdown popup is closed.

    Declaration
    public event EventHandler DropDownClosed
    Event Type
    Type
    System.EventHandler

    Focused

    Occurs when the control get focused.

    Declaration
    public event EventHandler<FocusEventArgs> Focused
    Event Type
    Type
    System.EventHandler<Microsoft.Maui.Controls.FocusEventArgs>

    LoadMoreButtonTapped

    Occurs when the LoadMore button is tapped.

    Declaration
    public event EventHandler<EventArgs> LoadMoreButtonTapped
    Event Type
    Type
    System.EventHandler<System.EventArgs>

    SelectionChanged

    Occurs when the current selection is changed.

    Declaration
    public event EventHandler<SelectionChangedEventArgs> SelectionChanged
    Event Type
    Type
    System.EventHandler<SelectionChangedEventArgs>

    SelectionChanging

    Occurs when the current selection is changing.

    Declaration
    public event EventHandler<SelectionChangingEventArgs> SelectionChanging
    Event Type
    Type
    System.EventHandler<SelectionChangingEventArgs>

    Unfocused

    Occurs when the control get unfocused.

    Declaration
    public event EventHandler<FocusEventArgs> Unfocused
    Event Type
    Type
    System.EventHandler<Microsoft.Maui.Controls.FocusEventArgs>

    Implements

    IDrawableLayout
    Microsoft.Maui.Graphics.IDrawable
    Microsoft.Maui.IAbsoluteLayout
    Microsoft.Maui.ILayout
    Microsoft.Maui.IView
    Microsoft.Maui.IElement
    Microsoft.Maui.ITransform
    Microsoft.Maui.IContainer
    System.Collections.Generic.IList<>
    System.Collections.Generic.ICollection<>
    System.Collections.Generic.IEnumerable<>
    System.Collections.IEnumerable
    Microsoft.Maui.ISafeAreaView
    Microsoft.Maui.IPadding
    Microsoft.Maui.ICrossPlatformLayout
    Microsoft.Maui.IVisualTreeElement
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved