Xceed Toolkit Plus for WPF v5.0 Documentation
Xceed.Wpf.Toolkit Assembly / Xceed.Wpf.Toolkit Namespace / CheckComboBox Class
Members Example


In This Topic
    CheckComboBox Class
    In This Topic
    Represents a combo box in which the items in the dropdown are preceded by a checkbox. 
    Syntax
    '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.
    <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

    See Also