Class SfMultiColumnDropDownControl

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

Constructors

SfMultiColumnDropDownControl()

Initializes a new instance of the SfMultiColumnDropDownControl class.

Declaration
public SfMultiColumnDropDownControl()

Fields

ActualPopupHeightProperty

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

Declaration
public static readonly DependencyProperty ActualPopupHeightProperty
Field Value
Type
System.Windows.DependencyProperty
Remarks

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

ActualPopupWidthProperty

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

Declaration
public static readonly DependencyProperty ActualPopupWidthProperty
Field Value
Type
System.Windows.DependencyProperty
Remarks

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

AllowAutoCompleteProperty

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

Declaration
public static readonly DependencyProperty AllowAutoCompleteProperty
Field Value
Type
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.DependencyProperty
Remarks

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

CornerRadiusProperty

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

Declaration
public static readonly DependencyProperty CornerRadiusProperty
Field Value
Type
System.Windows.DependencyProperty
Remarks

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

DisplayMemberProperty

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

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

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

FilterDelayProperty

Identifies the FilterDelay dependency property.

Declaration
public static readonly DependencyProperty FilterDelayProperty
Field Value
Type
System.Windows.DependencyProperty
Remarks

The identifier for the FilterDelay dependency property.

FilteredItemsProperty

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

Declaration
public static readonly DependencyProperty FilteredItemsProperty
Field Value
Type
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.DependencyProperty
Remarks

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

PopupContentTemplateProperty

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

Declaration
public static DependencyProperty PopupContentTemplateProperty
Field Value
Type
System.Windows.DependencyProperty
Remarks

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

PopupDropDownGridBackgroundProperty

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

Declaration
public static readonly DependencyProperty PopupDropDownGridBackgroundProperty
Field Value
Type
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.DependencyProperty
Remarks

The identifier for the SelectionMode dependency property.

SeparatorStringProperty

Identifies the SeparatorString dependency property.

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

The identifier for the SeparatorString dependency property.

SkipValidationProperty

Declaration
public static readonly DependencyProperty SkipValidationProperty
Field Value
Type
System.Windows.DependencyProperty

TextAlignmentProperty

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

Declaration
public static readonly DependencyProperty TextAlignmentProperty
Field Value
Type
System.Windows.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
System.Windows.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
System.Windows.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
System.Windows.DependencyProperty
Remarks

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

Properties

ActualPopupHeight

Gets the actual height of the pop-up.

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

The actual height of the pop-up.

ActualPopupWidth

Gets the actual width of the pop-up.

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

The actual width of the pop-up.

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

CornerRadius

Gets or sets the corner radius.

Declaration
public Thickness CornerRadius { get; set; }
Property Value
Type Description
System.Windows.Thickness

The corner radius.

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
System.Windows.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
System.Windows.Controls.ItemsControl

FilterDelay

Gets or sets a value that indicates the time(milliseconds) delay to perform auto-completion while typing in editor.

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

The default value is 500.
Remarks

Auto-completion operation will be delayed for a specified amount of time.

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

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
System.Windows.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

PopupBackground

Gets or sets the background to pop-up.

Declaration
public Brush PopupBackground { get; set; }
Property Value
Type Description
System.Windows.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
System.Windows.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
System.Windows.Thickness

The pop-up border thickness.

PopupContentTemplate

Declaration
public ControlTemplate PopupContentTemplate { get; set; }
Property Value
Type
System.Windows.Controls.ControlTemplate

PopupDropDownGridBackground

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

Declaration
public Brush PopupDropDownGridBackground { get; set; }
Property Value
Type Description
System.Windows.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
System.Windows.Visibility

One of the System.Windows.Visibility 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
System.Windows.TextAlignment

One of the System.Windows.TextAlignment 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
System.Windows.Size arrangeBounds

The computed size that is used to arrange the content in pop-up.
Returns
Type Description
System.Windows.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
System.Windows.DependencyObject obj
Returns
Type
System.Boolean

OnApplyTemplate()

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

Declaration
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates and returns an AutomationPeerHelper object for the SfMultiColumnDropDownControl.

Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
Type Description
System.Windows.Automation.Peers.AutomationPeer

Returns new instance of SfMultiColumnDropDownControlAutomationPeer for the SfMultiColumnDropDownControl.

OnMouseEnter(MouseEventArgs)

Invoked when the mouse pointer enters SfMultiColumnDropDownControl.

Declaration
protected override void OnMouseEnter(MouseEventArgs e)
Parameters
Type Name Description
System.Windows.Input.MouseEventArgs e

The System.Windows.Input.MouseEventArgs that contains the event data.

OnMouseLeave(MouseEventArgs)

Invoked when the mouse pointer leaves SfMultiColumnDropDownControl.

Declaration
protected override void OnMouseLeave(MouseEventArgs e)
Parameters
Type Name Description
System.Windows.Input.MouseEventArgs e

The System.Windows.Input.MouseEventArgs that contains the event data.

OnMouseWheel(MouseWheelEventArgs)

Invoked when the mouse wheel rotates over SfMultiColumnDropDownControl.

Declaration
protected override void OnMouseWheel(MouseWheelEventArgs e)
Parameters
Type Name Description
System.Windows.Input.MouseWheelEventArgs e

The System.Windows.Input.MouseWheelEventArgs that contains the event data.

OnPreviewKeyDown(KeyEventArgs)

Occurs when a key is pressed in SfMultiColumnDropDownControl.

Declaration
protected override void OnPreviewKeyDown(KeyEventArgs e)
Parameters
Type Name Description
System.Windows.Input.KeyEventArgs e

The System.Windows.Input.KeyEventArgs that contains the event data.

OnToolTipOpening(ToolTipEventArgs)

Invoked when the tooltip on the SfMultiColumnDropDownControl is opened.

Declaration
protected override void OnToolTipOpening(ToolTipEventArgs e)
Parameters
Type Name Description
System.Windows.Controls.ToolTipEventArgs e

The System.Windows.Controls.ToolTipEventArgs 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(KeyEventArgs)

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

Declaration
protected virtual void ProcessKeyDown(KeyEventArgs args)
Parameters
Type Name Description
System.Windows.Input.KeyEventArgs args

The event data

ProcessKeyDownOnMultiSelection(KeyEventArgs)

Occurs when a key is pressed when SelectionMode is Multiple.

Declaration
protected virtual void ProcessKeyDownOnMultiSelection(KeyEventArgs e)
Parameters
Type Name Description
System.Windows.Input.KeyEventArgs 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
System.Windows.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, MouseWheelEventArgs)

Occurs while doing mouse wheel in the control.

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

The source of the event
System.Windows.Input.MouseWheelEventArgs 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 and the location of the control in window. if AutoPopupSize is enabled, then PopupVerticalOffset is calculated based on remaining height of the editor in both top and bottom.

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
System.Windows.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