MultiColumnComboBox Class

ComboBox control that displays data in columns using Xceed's DataGridControl.

Syntax

Visual Basic
C#

'Declaration
 
<TemplatePartAttribute(Name="PART_dataGrid", Type=Xceed.Wpf.DataGrid.DataGridControl)>

<StyleTypedPropertyAttribute(Property="DataGridStyle", StyleTargetType=Xceed.Wpf.DataGrid.DataGridControl)>

<LocalizabilityAttribute(LocalizationCategory.ComboBox)>

<DefaultEventAttribute("SelectionChanged")>

<DefaultPropertyAttribute("SelectedIndex")>

<ContentPropertyAttribute("Items")>

<XmlLangPropertyAttribute("Language")>

<UsableDuringInitializationAttribute(True)>

<RuntimeNamePropertyAttribute("Name")>

<UidPropertyAttribute("Uid")>

<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>

<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>

Public Class MultiColumnComboBox 

   Inherits System.Windows.Controls.ComboBox

'Usage
 
Dim instance As MultiColumnComboBox

[TemplatePart(Name="PART_dataGrid", Type=Xceed.Wpf.DataGrid.DataGridControl)]

[StyleTypedProperty(Property="DataGridStyle", StyleTargetType=Xceed.Wpf.DataGrid.DataGridControl)]

[Localizability(LocalizationCategory.ComboBox)]

[DefaultEvent("SelectionChanged")]

[DefaultProperty("SelectedIndex")]

[ContentProperty("Items")]

[XmlLangProperty("Language")]

[UsableDuringInitialization(true)]

[RuntimeNameProperty("Name")]

[UidProperty("Uid")]

[TypeDescriptionProvider(MS.Internal.ComponentModel.DependencyObjectProvider)]

[NameScopeProperty("NameScope", System.Windows.NameScope)]

public class MultiColumnComboBox : System.Windows.Controls.ComboBox

Remarks

This control uses the DataGrid control included in the toolkit (Xceed Toolkit for WPF), which is a stripped version of the full DataGrid (Xceed DataGrid for WPF).

If the MultiColumnComboBox is defined beside a full DataGrid in an application, references to Xceed.Wpf.DataGrid.dll (from Xceed Toolkit for WPF) and Xceed.Wpf.DataGrid.v#.#.dll (from Xceed Datagrid for WPF) will be necessary. You will be able to define the 2 controls in XAML, but when trying to set some properties, the XAML Parser will not act as expected.

In this situation, you should set the properties of the MultiColumnComboBox and the Full DataGrid in code-behind. Since the DataGrid in the Toolkit is a stripped version of the full DataGrid, they will have the same namespaces and property names. A solution is to use aliases to differentiate the assemblies.

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         System.Windows.Media.Visual
            System.Windows.UIElement
               System.Windows.FrameworkElement
                  System.Windows.Controls.Control
                     System.Windows.Controls.ItemsControl
                        System.Windows.Controls.Primitives.Selector
                           System.Windows.Controls.ComboBox
                              Xceed.Wpf.DataGrid.Controls.MultiColumnComboBox

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

MultiColumnComboBox Members
Xceed.Wpf.DataGrid.Controls Namespace