menu

UWP

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class SfMultiColumnDropDownControl - UWP API Reference | Syncfusion

    Show / Hide Table of Contents

    Class SfMultiColumnDropDownControl

    Inheritance
    System.Object
    SfMultiColumnDropDownControl
    Implements
    System.IDisposable
    Namespace: Syncfusion.UI.Xaml.Grid
    Assembly: Syncfusion.SfGrid.UWP.dll
    Syntax
    public class SfMultiColumnDropDownControl : Control, IDisposable

    Constructors

    SfMultiColumnDropDownControl()

    Initializes a new instance of the SfMultiColumnDropDownControl class.

    Declaration
    public SfMultiColumnDropDownControl()

    Fields

    AllowAutoCompleteProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowAutoComplete dependency property.

    Declaration
    public static readonly DependencyProperty AllowAutoCompleteProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowAutoComplete dependency property.

    AllowCaseSensitiveFilteringProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowCaseSensitiveFiltering dependency property.

    Declaration
    public static readonly DependencyProperty AllowCaseSensitiveFilteringProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowCaseSensitiveFiltering dependency property.

    AllowDiacriticSensitiveFilteringProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowDiacriticSensitiveFiltering dependency property.

    Declaration
    public static readonly DependencyProperty AllowDiacriticSensitiveFilteringProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowDiacriticSensitiveFiltering dependency property.

    AllowImmediatePopupProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowImmediatePopup dependency property.

    Declaration
    public static readonly DependencyProperty AllowImmediatePopupProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowImmediatePopup dependency property.

    AllowIncrementalFilteringProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowIncrementalFiltering dependency property.

    Declaration
    public static readonly DependencyProperty AllowIncrementalFilteringProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowIncrementalFiltering dependency property.

    AllowNullInputProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowNullInput dependency property.

    Declaration
    public static readonly DependencyProperty AllowNullInputProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowAutoComplete dependency property.

    AllowSpinOnMouseWheelProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowSpinOnMouseWheel dependency property.

    Declaration
    public static readonly DependencyProperty AllowSpinOnMouseWheelProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AllowSpinOnMouseWheel dependency property.

    AutoGenerateColumnsModeProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AutoGenerateColumnsMode dependency property.

    Declaration
    public static readonly DependencyProperty AutoGenerateColumnsModeProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AutoGenerateColumnsMode dependency property.

    AutoGenerateColumnsProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AutoGenerateColumns dependency property.

    Declaration
    public static readonly DependencyProperty AutoGenerateColumnsProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.AutoGenerateColumns dependency property.

    ColumnsProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.Columns dependency property.

    Declaration
    public static readonly DependencyProperty ColumnsProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.Columns dependency property.

    DisplayMemberProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.DisplayMember dependency property.

    Declaration
    public static readonly DependencyProperty DisplayMemberProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.DisplayMember dependency property.

    FilteredItemsProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.FilteredItems dependency property.

    Declaration
    public static readonly DependencyProperty FilteredItemsProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.FilteredItems dependency property.

    GridColumnSizerProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.GridColumnSizer dependency property.

    Declaration
    public static readonly DependencyProperty GridColumnSizerProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.GridColumnSizer dependency property.

    HeaderTemplateProperty

    Identifies the HeaderTemplate dependency property.

    Declaration
    public static readonly DependencyProperty HeaderTemplateProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the HeaderTemplate dependency property.

    IsAutoPopupSizeProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.IsAutoPopupSize dependency property.

    Declaration
    public static readonly DependencyProperty IsAutoPopupSizeProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.IsAutoPopupSize dependency property.

    IsDropDownOpenProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.IsDropDownOpen dependency property.

    Declaration
    public static readonly DependencyProperty IsDropDownOpenProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.IsDropDownOpen dependency property.

    ItemsSourceProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ItemsSource dependency property.

    Declaration
    public static readonly DependencyProperty ItemsSourceProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ItemsSource dependency property.

    PopupBackgroundProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBackground dependency property.

    Declaration
    public static readonly DependencyProperty PopupBackgroundProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBackground dependency property.

    PopupBorderBrushProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBorderBrush dependency property.

    Declaration
    public static readonly DependencyProperty PopupBorderBrushProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBorderBrush dependency property.

    PopupBorderThicknessProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBorderThickness dependency property.

    Declaration
    public static readonly DependencyProperty PopupBorderThicknessProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupBorderThickness dependency property.

    PopupDropDownGridBackgroundProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupDropDownGridBackground dependency property.

    Declaration
    public static readonly DependencyProperty PopupDropDownGridBackgroundProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupDropDownGridBackground dependency property.

    PopupHeightProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupHeight dependency property.

    Declaration
    public static readonly DependencyProperty PopupHeightProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupHeight dependency property.

    PopupMaxHeightProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopUpMaxHeight dependency property.

    Declaration
    public static readonly DependencyProperty PopupMaxHeightProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopUpMaxHeight dependency property.

    PopupMaxWidthProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMaxWidth dependency property.

    Declaration
    public static readonly DependencyProperty PopupMaxWidthProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMaxWidth dependency property.

    PopupMinHeightProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMinHeight dependency property.

    Declaration
    public static DependencyProperty PopupMinHeightProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMinHeight dependency property.

    PopupMinWidthProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMinWidth dependency property.

    Declaration
    public static DependencyProperty PopupMinWidthProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupMinWidth dependency property.

    PopupWidthProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupWidth dependency property.

    Declaration
    public static readonly DependencyProperty PopupWidthProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.PopupWidth dependency property.

    ReadOnlyProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ReadOnly dependency property.

    Declaration
    public static readonly DependencyProperty ReadOnlyProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ReadOnly dependency property.

    ResizingThumbVisibilityProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ResizingThumbVisibility dependency property.

    Declaration
    public static readonly DependencyProperty ResizingThumbVisibilityProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ResizingThumbVisibility dependency property.

    SearchConditionProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SearchCondition dependency property.

    Declaration
    public static readonly DependencyProperty SearchConditionProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SearchCondition dependency property.

    SearchTextProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SearchText dependency property.

    Declaration
    public static readonly DependencyProperty SearchTextProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SearchText dependency property.

    SelectedIndexProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedIndex dependency property.

    Declaration
    public static readonly DependencyProperty SelectedIndexProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedIndex dependency property.

    SelectedItemProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedItem dependency property.

    Declaration
    public static readonly DependencyProperty SelectedItemProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedItem dependency property.

    SelectedItemsProperty

    Identifies the SelectedItems dependency property.

    Declaration
    public static readonly DependencyProperty SelectedItemsProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the SelectedItems dependency property.

    SelectedValueProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedValue dependency property.

    Declaration
    public static readonly DependencyProperty SelectedValueProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.SelectedValue dependency property.

    SelectionModeProperty

    Identifies the SelectionMode dependency property.

    Declaration
    public static readonly DependencyProperty SelectionModeProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the SelectionMode dependency property.

    SeparatorStringProperty

    Identifies the SeparatorString dependency property.

    Declaration
    public static readonly DependencyProperty SeparatorStringProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the SeparatorString dependency property.

    SkipValidationProperty

    Declaration
    public static readonly DependencyProperty SkipValidationProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty

    TextAlignmentProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.TextAlignment dependency property.

    Declaration
    public static readonly DependencyProperty TextAlignmentProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.TextAlignment dependency property.

    TextProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.Text dependency property.

    Declaration
    public static readonly DependencyProperty TextProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.Text dependency property.

    TextSelectionOnFocusProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.TextSelectionOnFocus dependency property.

    Declaration
    public static readonly DependencyProperty TextSelectionOnFocusProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.TextSelectionOnFocus dependency property.

    ValueMemberProperty

    Identifies the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ValueMember dependency property.

    Declaration
    public static readonly DependencyProperty ValueMemberProperty
    Field Value
    Type
    Windows.UI.Xaml.DependencyProperty
    Remarks

    The identifier for the Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.ValueMember dependency property.

    Properties

    AllowAutoComplete

    Gets or sets a value that indicates whether the textbox text is need to auto append rather than typing the entire text in Textbox.

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

    true if the auto completion is enabled; otherwise, false. The default value is true.

    AllowCaseSensitiveFiltering

    Gets or sets a value that indicates the case-sensitive when AllowIncrementalFiltering and AllowAutoComplete is enabled.

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

    true if the case-sensitive is enabled for AllowIncrementalFiltering, AllowAutoComplete; otherwise, false. The default value is false.

    AllowDiacriticSensitiveFiltering

    Gets or sets a value that indicates whether the diacritic is enabled or not in the SfMultiColumnDropDownControl control.

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

    The default value is true.

    AllowImmediatePopup

    Gets or sets a value that indicates whether the pop-up is open while typing the value in Textbox itself.

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

    true if the pop-up is opened while typing the text in Textbox; otherwise, false. The default value is false.

    AllowIncrementalFiltering

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

    AllowNullInput

    Gets or sets a value that indicates whether the null values are allowed in the Textbox.

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

    true if the null values are allowed; otherwise, false. The default value is false.

    AllowSpinOnMouseWheel

    Gets or sets a SelectedItem when mouse wheel over the control.

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

    true if the SelectedItem gets changed when mouse wheel over the control; otherwise, false. The default value is true.

    AutoGenerateColumns

    Gets or sets a value that indicates whether the columns are created automatically.

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

    true if the columns are automatically generated; otherwise, false. The default value is true.

    AutoGenerateColumnsMode

    Gets or sets a value that indicates how the columns are generated when AutoGenerateColumns is enabled.

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

    One of the AutoGenerateColumnsMode enumeration that specifies the mode of automatic column generation. The default value is Syncfusion.UI.Xaml.SfDataGrid.AutoGenerateColumnsMode.None.

    Columns

    Gets or sets the collection that contains all the columns in SfMultiColumnDropDownControl.

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

    The collection that contains all the columns in SfMultiColumnDropDownControl.

    See Also
    Columns

    DisplayMember

    Gets or sets the path in underlying data object which is used to display the visual presentation of the control.

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

    A string specifying the name of an object in underlying data object which is used to display the text in control. The default value is string.Empty.

    Editor

    Gets or sets the TextBox which is loaded as editor in SfMultiColumnDropDownControl.

    Declaration
    protected TextBox Editor { get; set; }
    Property Value
    Type
    Windows.UI.Xaml.Controls.TextBox

    EditorPanel

    Gets or sets the panel which is loaded as editor in SfMultiColumnDropDownControl when SelectionMode is Multiple.

    Declaration
    protected ItemsControl EditorPanel { get; set; }
    Property Value
    Type
    Windows.UI.Xaml.Controls.ItemsControl

    FilteredItems

    Gets the filtered items from the SfDataGrid which is present in the pop-up.

    Declaration
    public IEnumerable FilteredItems { get; }
    Property Value
    Type Description
    System.Collections.IEnumerable

    The filtered items. The default value is null.

    GridColumnSizer

    Gets or sets a value that indicates how the columns widths are determined in SfDataGrid which is present in the pop-up.

    Declaration
    public GridLengthUnitType GridColumnSizer { get; set; }
    Property Value
    Type Description
    GridLengthUnitType

    One of the enumeration in GridLengthUnitTypethat adjust the column width. The default value is Syncfusion.UI.Xaml.Grid.GridLengthUnitType.None.

    See Also
    GridColumnSizer

    HeaderTemplate

    Gets or sets the System.Windows.DataTemplate that defines the visual representation of the header for the drop-down.

    Declaration
    public DataTemplate HeaderTemplate { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.DataTemplate

    The default value is null.

    Examples
    <syncfusion:SfMultiColumnDropDownControl.HeaderTemplate>
        <DataTemplate>
            <TextBlock Margin="5" Text="Header" FontWeight="Bold"/>
        </DataTemplate>
    </syncfusion:SfMultiColumnDropDownControl.HeaderTemplate>

    IsAutoPopupSize

    Gets or sets a value that indicates whether the pop-up height and width is automatically adjusted based on rows and columns count.

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

    true if the pop-up height and width is automatically adjusted based on rows and column count; otherwise, false. The default value is true.

    Remarks

    PopupHeight PopupWidth

    IsDropDownOpen

    Gets or sets a value that indicates whether the drop-down is need to open while loading itself.

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

    true if the drop-down in opened state; otherwise, false. The default value is false.

    ItemsSource

    Gets or sets the collection that is used to generate the content of SfDataGrid which is present in the pop-up.

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

    The collection that is used to generate the content of SfDataGrid in pop-up. The default value is null.

    See Also
    ItemsSource

    PopupBackground

    Gets or sets the background to pop-up.

    Declaration
    public Brush PopupBackground { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.Media.Brush

    The pop-up background. The default value is Colors.Gainsboro.

    PopupBorderBrush

    Gets or sets the border brush to the pop-up.

    Declaration
    public Brush PopupBorderBrush { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.Media.Brush

    The pop-up border brush.

    PopupBorderThickness

    Gets or sets the border thickness to the pop-up.

    Declaration
    public Thickness PopupBorderThickness { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.Thickness

    The pop-up border thickness.

    PopupDropDownGridBackground

    Gets or sets the background to the SfDataGrid displayed in the pop-up.

    Declaration
    public Brush PopupDropDownGridBackground { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.Media.Brush

    The SfDataGrid background. The default value is Colors.White.

    PopupHeight

    Gets or sets the height of pop-up.

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

    The height of the pop-up. The PopupMinHeight is set as the default height of the pop-up.

    Remarks

    When IsAutoPopupSize is true, the given pop-up height won't considered. Pop-up height will be calculated based on number of rows in a pop-up. When IsAutoPopupSize is false, then the given Pop-up height will be considered. if the given pop-up height is greater than the available height, then the pop-up height will set based on the available maximum height by considering top and bottom side of the window. if the given pop-up height is less than the PopupMinHeight, then PopupMinHeight will set as Pop-up height by not considering IsAutoPopupSize.

    PopupMaxHeight

    Gets or sets the maximum height constraint of the pop-up.

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

    The maximum height of the pop-up.

    Remarks

    PopupHeight

    PopupMaxWidth

    Gets or sets the maximum width constraint of the pop-up.

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

    The maximum width of the pop-up.

    Remarks

    PopupWidth

    PopupMinHeight

    Gets or sets the minimum height constraint of the pop-up.

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

    The minimum height of the pop-up. The default value is 300.0.

    PopupMinWidth

    Gets or sets the minimum width constraint of the pop-up.

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

    The minimum width of the pop-up. The default value is 200.0.

    PopupWidth

    Gets or sets the width of the pop-up.

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

    The width of the pop-up. The PopupMinWidth is set as the default width of the pop-up.

    Remarks

    When IsAutoPopupSize is true, the given Pop-up Width won't considered. Pop-up width will be calculated based on the number of columns in a SfDataGrid. When IsAutoPopupSize is false, then the given Pop-up width will be considered. if the given pop-up width is greater than the available width, then the pop-up width will be set based on the available maximum width by considering left and right side of the window. if the given pop-up width is less than the PopupMinWidth, then PopupMinWidth will set as Pop-up Width by not considering IsAutoPopupSize.

    ReadOnly

    Gets or sets a value that indicates whether the Textbox is allowed to edit or not.

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

    true if the Textbox is read-only; otherwise, false. The default value is false.

    ResizingThumbVisibility

    Gets or sets a value that indicates the visibility of resizing thumb which is used to resize the pop-up.

    Declaration
    public Visibility ResizingThumbVisibility { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.Visibility

    One of the enumeration that specifies visibility of resizing thumb. The default value is Visibility.Visible.

    SearchCondition

    Gets or sets a value that indicates how the records are filter when AllowIncrementalFiltering is enabled.

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

    One of the enumeration SearchCondition that denotes the filtering condition. The default value is StartsWith.

    Remarks

    Records are filtered based on SearchCondition when AllowIncrementalFiltering is enabled.

    SearchText

    Gets the text which is entered in the Textbox.

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

    The text which is entered in the Textbox. The default value is String.Empty.

    SelectedIndex

    Gets or sets the index of selected row in SfDataGrid which is present in pop-up.

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

    Index of the The default value is -1.

    SelectedItem

    Gets or sets the data item which is bound to the row that contains the selection.

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

    The object that is currently selected in the SfDataGrid. The default value is null.

    SelectedItems

    Gets or sets the collection of object that contains the data item of corresponding selected rows.

    Declaration
    public ObservableCollection<object> SelectedItems { get; set; }
    Property Value
    Type Description
    System.Collections.ObjectModel.ObservableCollection<System.Object>

    The collection of object that is currently selected in the drop-down grid.

    SelectedValue

    Gets or sets the value based on ValueMember from SelectedItem.

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

    The selected value will be set based on ValueMember. The default value is null.

    SelectionMode

    Gets or sets a value that indicates the drop-down selection mode.

    Declaration
    public DropDownSelectionMode SelectionMode { get; set; }
    Property Value
    Type Description
    DropDownSelectionMode

    The default value is Single.

    SeparatorString

    Gets or sets a value that indicates the string which is used to separate the selected values in editor.

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

    The default value is ;.

    Text

    Gets or sets a string that specifies the text displayed in the Textbox.

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

    A string that specifies the text displayed in the Textbox. The default value is string.Empty.

    TextAlignment

    Gets or sets the horizontal alignment of the text displayed in the Textbox.

    Declaration
    public TextAlignment TextAlignment { get; set; }
    Property Value
    Type Description
    Windows.UI.Xaml.TextAlignment

    One of the enumeration that specifies the horizontal alignment of the Textbox text. The default value is TextAlignment.Left.

    TextSelectionOnFocus

    Gets or sets a value that indicates whether the Textbox text is selected or not while focusing it.

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

    trueif select the text in Textbox; otherwise, false.

    ValueMember

    Gets or sets the path in underlying data object which is used to get the SelectedValue.

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

    A string specifying the name of an object in underlying data object which is used to get the SelectedValue from the SelectedItem. The default value is string.Empty.

    Methods

    add_PopupClosed(PopupClosedEventHandler)

    Declaration
    public void add_PopupClosed(PopupClosedEventHandler value)
    Parameters
    Type Name Description
    PopupClosedEventHandler value

    add_PopupClosing(PopupClosingEventHandler)

    Declaration
    public void add_PopupClosing(PopupClosingEventHandler value)
    Parameters
    Type Name Description
    PopupClosingEventHandler value

    add_PopupOpening(PopupOpeningEventHandler)

    Declaration
    public void add_PopupOpening(PopupOpeningEventHandler value)
    Parameters
    Type Name Description
    PopupOpeningEventHandler value

    add_SelectionChanged(SelectionChangedEventHandler)

    Declaration
    public void add_SelectionChanged(SelectionChangedEventHandler value)
    Parameters
    Type Name Description
    SelectionChangedEventHandler value

    ArrangeOverride(Size)

    Arranges the content of the pop-up.

    Declaration
    protected override Size ArrangeOverride(Size arrangeBounds)
    Parameters
    Type Name Description
    Windows.Foundation.Size arrangeBounds

    The computed size that is used to arrange the content in pop-up.

    Returns
    Type Description
    Windows.Foundation.Size

    The size consumed by the content in pop-up.

    CommitValue(Boolean)

    Commit the given value in the editor.

    Declaration
    protected virtual void CommitValue(bool autoCommit = false)
    Parameters
    Type Name Description
    System.Boolean autoCommit

    If it is true, set the selected item directly otherwise set the selected item based on DisplayMember.

    Dispose()

    Disposes all the resources used by the SfMultiColumnDropDownControl.

    Declaration
    public void Dispose()

    Dispose(Boolean)

    Disposes all the resources used by the SfMultiColumnDropDownControl.

    Declaration
    protected virtual void Dispose(bool isDisposing)
    Parameters
    Type Name Description
    System.Boolean isDisposing

    Indicates whether the call is from Dispose method or from a finalizer.

    DropDownAutoSize()

    Calculate the pop-up height and Width when IsAutoPopupSize is enabled.

    Declaration
    protected virtual void DropDownAutoSize()
    Remarks

    Based on maximum available height in Top and bottom of the window from control, the pop-up height will be calculated. Likewise, pop-up width also calculated based on available width in left and right of the control. PopupHeight PopupWidth

    FilterRecord(Object)

    Declaration
    protected virtual bool FilterRecord(object item)
    Parameters
    Type Name Description
    System.Object item
    Returns
    Type
    System.Boolean

    GetDropDownGrid()

    Returns the Embedded DropDown DataGrid in the Pop-up.

    Declaration
    public SfDataGrid GetDropDownGrid()
    Returns
    Type Description
    SfDataGrid

    SfDataGrid which is loaded in pop-up.

    GetSkipValidation(DependencyObject)

    Attached property To Skip Cell validation

    Declaration
    public static bool GetSkipValidation(DependencyObject obj)
    Parameters
    Type Name Description
    Windows.UI.Xaml.DependencyObject obj
    Returns
    Type
    System.Boolean

    OnApplyTemplate()

    Builds the visual tree for the SfMultiColumnDropDownControl when a new template is applied.

    Declaration
    protected override void OnApplyTemplate()

    OnKeyDown(KeyRoutedEventArgs)

    Occurs when a key is pressed in SfMultiColumnDropDownControl.

    Declaration
    protected override void OnKeyDown(KeyRoutedEventArgs e)
    Parameters
    Type Name Description
    Windows.UI.Xaml.Input.KeyRoutedEventArgs e

    The Windows.UI.Xaml.Input.KeyRoutedEventArgs that contains the event data.

    ProcessAppendStringList(Object, String)

    Returns the new string list for the given value.

    Declaration
    protected virtual List<string> ProcessAppendStringList(object item, string _value)
    Parameters
    Type Name Description
    System.Object item

    The record

    System.String _value

    New string list will be created based on the value.

    Returns
    Type Description
    System.Collections.Generic.List<System.String>

    Created string list

    ProcessAppendText(Object, String, String)

    Checks whether the given exact value is starts with the filter text.

    Declaration
    protected virtual bool ProcessAppendText(object item, string exactValue, string filterText)
    Parameters
    Type Name Description
    System.Object item

    The record

    System.String exactValue

    The original value

    System.String filterText

    The entered text in the editor.

    Returns
    Type Description
    System.Boolean

    true if the exactValue is begins with filterText; otherwise, false.

    ProcessIncrementalFiltering()

    Processes the immediate filtering when typing the text in editor.

    Declaration
    protected virtual void ProcessIncrementalFiltering()

    ProcessKeyDown(KeyRoutedEventArgs)

    Occurs when a key is pressed when the control has focus.

    Declaration
    protected virtual void ProcessKeyDown(KeyRoutedEventArgs args)
    Parameters
    Type Name Description
    Windows.UI.Xaml.Input.KeyRoutedEventArgs args

    The event data

    ProcessKeyDownOnMultiSelection(KeyRoutedEventArgs)

    Occurs when a key is pressed when SelectionMode is Multiple.

    Declaration
    protected virtual void ProcessKeyDownOnMultiSelection(KeyRoutedEventArgs e)
    Parameters
    Type Name Description
    Windows.UI.Xaml.Input.KeyRoutedEventArgs e

    The Windows.UI.Xaml.Input.KeyRoutedEventArgs that contains the event data.

    ProcessOnEditorTextChanged(Object, TextChangedEventArgs)

    Occurs when the editor text gets changed.

    Declaration
    protected virtual void ProcessOnEditorTextChanged(object sender, TextChangedEventArgs e)
    Parameters
    Type Name Description
    System.Object sender

    The sender of the event

    Windows.UI.Xaml.Controls.TextChangedEventArgs e

    The event data

    Remarks

    This event is raised if the editor text has been changed by either a programmatic modification or user interaction.

    ProcessOnMouseWheelSpin(Object, PointerRoutedEventArgs)

    Occurs while doing mouse wheel in the control.

    Declaration
    protected virtual void ProcessOnMouseWheelSpin(object sender, PointerRoutedEventArgs e)
    Parameters
    Type Name Description
    System.Object sender

    The source of the event

    Windows.UI.Xaml.Input.PointerRoutedEventArgs e

    The event data.

    ProcessOnPopupPositionCalculation()

    Pop-up positions ( Horizontal and Vertical offsets) are calculated based on Pop-up height and width.

    Declaration
    protected virtual void ProcessOnPopupPositionCalculation()
    Remarks

    calculate the pop-up position based on the height of the window, location of the control in window. and its mode ( Whether it is Editable or Non-Editable). In Editable mode,Pop-up will be loaded in below the editor, if the pop-up height is greater than remaining below height of the window ( below space is not enough to load the pop-up, then the pop-up will open in above the editor. In Non-Editable, ContentControl is loaded instead of TextBox. In Non-Editable mode, Pop will be loaded behind the editor ( like the behavior of Combo-box ). if AutoPopupSize is enabled, then the VerticalOffset and Horizontal offset are calculated. . if AutoPopupSize is not enabled, then the pop-up height will be the DefaultMinHeight and pop-up width will be the DefaultMinWidth. if the IsAutoPopupSize is false, then the HorizontalOffset is -2.

    remove_PopupClosed(PopupClosedEventHandler)

    Declaration
    public void remove_PopupClosed(PopupClosedEventHandler value)
    Parameters
    Type Name Description
    PopupClosedEventHandler value

    remove_PopupClosing(PopupClosingEventHandler)

    Declaration
    public void remove_PopupClosing(PopupClosingEventHandler value)
    Parameters
    Type Name Description
    PopupClosingEventHandler value

    remove_PopupOpening(PopupOpeningEventHandler)

    Declaration
    public void remove_PopupOpening(PopupOpeningEventHandler value)
    Parameters
    Type Name Description
    PopupOpeningEventHandler value

    remove_SelectionChanged(SelectionChangedEventHandler)

    Declaration
    public void remove_SelectionChanged(SelectionChangedEventHandler value)
    Parameters
    Type Name Description
    SelectionChangedEventHandler value

    SetDisplayText(Object)

    Set the text to the Textbox.

    Declaration
    protected virtual void SetDisplayText(object selectedItem = null)
    Parameters
    Type Name Description
    System.Object selectedItem

    Selected item of the SfDataGrid.

    SetSelectedValue(Object)

    Set the selected value to the SfMultiColumnDropDownControl based on the selected item.

    Declaration
    protected virtual void SetSelectedValue(object selectedItem)
    Parameters
    Type Name Description
    System.Object selectedItem

    SelectedItem of the SfDataGrid.

    SetSkipValidation(DependencyObject, Boolean)

    Declaration
    public static void SetSkipValidation(DependencyObject obj, bool value)
    Parameters
    Type Name Description
    Windows.UI.Xaml.DependencyObject obj
    System.Boolean value

    Events

    AutoGeneratingColumn

    Occurs when column is generated for the properties in underlying data object.

    Declaration
    public event EventHandler<AutoGeneratingColumnArgs> AutoGeneratingColumn
    Event Type
    Type
    System.EventHandler<AutoGeneratingColumnArgs>
    Remarks

    You can cancel or customize the column being created using the AutoGeneratingColumnArgs event argument.

    Examples
    // Wired the Autogeneratingcolumn event.
    this.multiColumnDropDown.AutoGeneratingColumn += MultiColumnDropDown_AutoGeneratingColumn;
    // Occurs while column is generated.
    void MultiColumnDropDown_AutoGeneratingColumn(object sender, AutoGeneratingColumnArgs e)
    {
       if (e.Column.MappingName == "SerialNumber")
       {
           // To change the column type
           if (e.Column is GridNumericColumn)
           {
               e.Column = new GridTextColumn() { MappingName = "SerialNumber", HeaderText = "Serial Number" };
           }
       }
       else if (e.Column.MappingName == "Cast")
       {
           //To cancel the autogeneration of column.
           e.Cancel = true;
       }
       else if (e.Column.MappingName == "Director")
       {
           // To  customize the column properties.
           e.Column.AllowSorting = false;
           e.Column.AllowFiltering = true;
       }
    }

    PopupClosed

    Occurs when the Pop-up is Closed.

    Declaration
    public event PopupClosedEventHandler PopupClosed
    Event Type
    Type
    PopupClosedEventHandler

    PopupClosing

    Occurs when the Pop-up is Closing.

    Declaration
    public event PopupClosingEventHandler PopupClosing
    Event Type
    Type
    PopupClosingEventHandler

    PopupOpened

    Occurs when the Pop-up is Opened.

    Declaration
    public event EventHandler<PopupOpenedEventArgs> PopupOpened
    Event Type
    Type
    System.EventHandler<PopupOpenedEventArgs>

    PopupOpening

    Occurs when the Pop-up is Opening.

    Declaration
    public event PopupOpeningEventHandler PopupOpening
    Event Type
    Type
    PopupOpeningEventHandler
    Remarks

    Pop-up opening can be skipped through PopupOpeningEventArgs event argument.

    SelectionChanged

    Occurs when the Selection is Changed.

    Declaration
    public event SelectionChangedEventHandler SelectionChanged
    Event Type
    Type
    SelectionChangedEventHandler
    Remarks

    Selected index and Selected item can be accessed through SelectionChangedEventArgs event argument.

    Implements

    System.IDisposable

    Extension Methods

    DateTimeExtension.ToDateTime(Object)
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved