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	Description
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	Description
Windows.UI.Xaml.DependencyProperty

Remarks

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

AllowImmediatePopupProperty

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

Declaration

public static readonly DependencyProperty AllowImmediatePopupProperty

Field Value

Type	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
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	Description
Windows.UI.Xaml.DependencyProperty

Remarks

The identifier for the SeparatorString dependency property.

SkipValidationProperty

Declaration

public static readonly DependencyProperty SkipValidationProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TextAlignmentProperty

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

Declaration

public static readonly DependencyProperty TextAlignmentProperty

Field Value

Type	Description
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	Description
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	Description
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	Description
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.

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

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

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.

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	Description
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	Description
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

PopupClosed

Occurs when the Pop-up is Closed.

Declaration

public event PopupClosedEventHandler PopupClosed

Event Type

Type	Description
PopupClosedEventHandler

PopupClosing

Occurs when the Pop-up is Closing.

Declaration

public event PopupClosingEventHandler PopupClosing

Event Type

Type	Description
PopupClosingEventHandler

PopupOpened

Occurs when the Pop-up is Opened.

Declaration

public event EventHandler<PopupOpenedEventArgs> PopupOpened

Event Type

Type	Description
System.EventHandler<PopupOpenedEventArgs>

PopupOpening

Occurs when the Pop-up is Opening.

Declaration

public event PopupOpeningEventHandler PopupOpening

Event Type

Type	Description
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	Description
SelectionChangedEventHandler

Remarks

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

Implements

System.IDisposable

Extension Methods

DateTimeExtension.ToDateTime(Object)

UWP- v18.3.0.35

Class SfMultiColumnDropDownControl

Inheritance

Implements

Namespace: Syncfusion.UI.Xaml.Grid

Assembly: Syncfusion.SfGrid.UWP.dll

Syntax

Constructors

SfMultiColumnDropDownControl()

Declaration

Fields

AllowAutoCompleteProperty

Declaration

Field Value

Remarks

AllowCaseSensitiveFilteringProperty

Declaration

Field Value

Remarks

AllowImmediatePopupProperty

Declaration

Field Value

Remarks

AllowIncrementalFilteringProperty

Declaration

Field Value

Remarks

AllowNullInputProperty

Declaration

Field Value

Remarks

AllowSpinOnMouseWheelProperty

Declaration

Field Value

Remarks

AutoGenerateColumnsModeProperty

Declaration

Field Value

Remarks

AutoGenerateColumnsProperty

Declaration

Field Value

Remarks

ColumnsProperty

Declaration

Field Value

Remarks

DisplayMemberProperty

Declaration

Field Value

Remarks

FilteredItemsProperty

Declaration

Field Value

Remarks

GridColumnSizerProperty

Declaration

Field Value

Remarks

HeaderTemplateProperty

Declaration

Field Value

Remarks

IsAutoPopupSizeProperty

Declaration

Field Value

Remarks

IsDropDownOpenProperty

Declaration

Field Value

Remarks

ItemsSourceProperty

Declaration

Field Value

Remarks

PopupBackgroundProperty

Declaration

Field Value

Remarks

PopupBorderBrushProperty