CheckComboBox Class

Represents a combo box in which the items in the dropdown are preceded by a checkbox.

Syntax

Visual Basic
C#

'Declaration
 
<TemplatePartAttribute(Name="PART_Popup", Type=System.Windows.Controls.Primitives.Popup)>
<DefaultEventAttribute("OnItemsChanged")>
<DefaultPropertyAttribute("Items")>
<ContentPropertyAttribute("Items")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=System.Windows.FrameworkElement)>
<LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)>
<XmlLangPropertyAttribute("Language")>
<UsableDuringInitializationAttribute(True)>
<RuntimeNamePropertyAttribute("Name")>
<UidPropertyAttribute("Uid")>
<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>
<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>
Public Class CheckComboBox 
   Inherits Xceed.Wpf.Toolkit.Primitives.SelectAllSelector

'Usage
 
Dim instance As CheckComboBox

[TemplatePart(Name="PART_Popup", Type=System.Windows.Controls.Primitives.Popup)]
[DefaultEvent("OnItemsChanged")]
[DefaultProperty("Items")]
[ContentProperty("Items")]
[StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=System.Windows.FrameworkElement)]
[Localizability(LocalizationCategory.None, Readability=Readability.Unreadable)]
[XmlLangProperty("Language")]
[UsableDuringInitialization(true)]
[RuntimeNameProperty("Name")]
[UidProperty("Uid")]
[TypeDescriptionProvider(MS.Internal.ComponentModel.DependencyObjectProvider)]
[NameScopeProperty("NameScope", System.Windows.NameScope)]
public class CheckComboBox : Xceed.Wpf.Toolkit.Primitives.SelectAllSelector

Remarks

As items are checked or unchecked, the Text property displayed above the dropdown is updated using the concatenated string representations of the checked items. The text displayed is formatted using the value of the Delimiter property to separate the individual strings.

CheckBox.IsSelected can be data bound using the SelectedMemberPath property.

Example

The following example shows how to create a CheckComboBox.

XAML

<xctk:CheckComboBox x:Name="_combo" 
                    HorizontalAlignment="Center" 
                    VerticalAlignment="Center" 
                    DisplayMemberPath="Color"
                    ValueMemberPath="Level"
                    SelectedValue="{Binding SelectedValue}"
                    SelectedItems="{Binding SelectedItems}" />

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
                        Xceed.Wpf.Toolkit.Primitives.Selector
                           Xceed.Wpf.Toolkit.Primitives.SelectAllSelector
                              Xceed.Wpf.Toolkit.CheckComboBox
                                 Xceed.Wpf.Toolkit.PropertyGrid.Editors.PropertyGridEditorEnumCheckComboBox

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

CheckComboBox Members
Xceed.Wpf.Toolkit Namespace