Intersoft ClientUI Documentation
UXMultipleSelectionComboBox Class
Members  See Also  Send Feedback
Intersoft.Client.UI.Data Namespace : UXMultipleSelectionComboBox Class






Object Model

UXMultipleSelectionComboBox Class

Syntax

Visual Basic (Declaration) 
<TemplateVisualStateAttribute(Name="Valid", GroupName="ValidationStates")>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="TextElement", Type=System.Windows.Controls.TextBlock)>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")>
<TemplatePartAttribute(Name="HeadersPresenter", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="InputElement", Type=Intersoft.Client.UI.Controls.UXTextBox)>
<TemplatePartAttribute(Name="ContentPresenter", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")>
<TemplatePartAttribute(Name="PopupElement", Type=Intersoft.Client.UI.Controls.UXPopup)>
<TemplatePartAttribute(Name="NonEditableElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="EditableElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="StatusElement", Type=System.Windows.Controls.Grid)>
<DescriptionAttribute("Represents a multiple selection combo box control.")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")>
<TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidUnfocused")>
<TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidFocused")>
<TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarVisible")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")>
<TemplatePartAttribute(Name="SelectionInputElement", Type=Intersoft.Client.UI.Data.SelectionInputControl)>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")>
<TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarCollapsed")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")>
<TemplatePartAttribute(Name="MoreButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)>
<TemplatePartAttribute(Name="ClearButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)>
<TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")>
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")>
Public Class UXMultipleSelectionComboBox 
   Inherits UXDataComboBox
   Implements IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection 
Visual Basic (Usage)Copy Code
Dim instance As UXMultipleSelectionComboBox
C# 
[TemplateVisualStateAttribute(Name="Valid", GroupName="ValidationStates")]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="TextElement", Type=System.Windows.Controls.TextBlock)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplatePartAttribute(Name="HeadersPresenter", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InputElement", Type=Intersoft.Client.UI.Controls.UXTextBox)]
[TemplatePartAttribute(Name="ContentPresenter", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplatePartAttribute(Name="PopupElement", Type=Intersoft.Client.UI.Controls.UXPopup)]
[TemplatePartAttribute(Name="NonEditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="EditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="StatusElement", Type=System.Windows.Controls.Grid)]
[DescriptionAttribute("Represents a multiple selection combo box control.")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidUnfocused")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidFocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarVisible")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplatePartAttribute(Name="SelectionInputElement", Type=Intersoft.Client.UI.Data.SelectionInputControl)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarCollapsed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplatePartAttribute(Name="MoreButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplatePartAttribute(Name="ClearButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
public class UXMultipleSelectionComboBox : UXDataComboBox, IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection 
Delphi 
public class UXMultipleSelectionComboBox = class(UXDataComboBox, IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection)
JScript 
TemplateVisualStateAttribute(Name="Valid", GroupName="ValidationStates")
TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="TextElement", Type=System.Windows.Controls.TextBlock)
TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")
TemplatePartAttribute(Name="HeadersPresenter", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="InputElement", Type=Intersoft.Client.UI.Controls.UXTextBox)
TemplatePartAttribute(Name="ContentPresenter", Type=Intersoft.Client.UI.Controls.StylishLabel)
TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")
TemplatePartAttribute(Name="PopupElement", Type=Intersoft.Client.UI.Controls.UXPopup)
TemplatePartAttribute(Name="NonEditableElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="EditableElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="StatusElement", Type=System.Windows.Controls.Grid)
DescriptionAttribute("Represents a multiple selection combo box control.")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")
TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidUnfocused")
TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidFocused")
TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarVisible")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")
TemplatePartAttribute(Name="SelectionInputElement", Type=Intersoft.Client.UI.Data.SelectionInputControl)
TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")
TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarCollapsed")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")
TemplatePartAttribute(Name="MoreButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)
TemplatePartAttribute(Name="ClearButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)
TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")
TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")
public class UXMultipleSelectionComboBox extends UXDataComboBox implements IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection 
Managed Extensions for C++ 
[TemplateVisualStateAttribute(Name="Valid", GroupName="ValidationStates")]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="TextElement", Type=System.Windows.Controls.TextBlock)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplatePartAttribute(Name="HeadersPresenter", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InputElement", Type=Intersoft.Client.UI.Controls.UXTextBox)]
[TemplatePartAttribute(Name="ContentPresenter", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplatePartAttribute(Name="PopupElement", Type=Intersoft.Client.UI.Controls.UXPopup)]
[TemplatePartAttribute(Name="NonEditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="EditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="StatusElement", Type=System.Windows.Controls.Grid)]
[DescriptionAttribute("Represents a multiple selection combo box control.")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidUnfocused")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidFocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarVisible")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplatePartAttribute(Name="SelectionInputElement", Type=Intersoft.Client.UI.Data.SelectionInputControl)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarCollapsed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplatePartAttribute(Name="MoreButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplatePartAttribute(Name="ClearButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
public __gc class UXMultipleSelectionComboBox : public UXDataComboBox, IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection 
C++/CLI 
[TemplateVisualStateAttribute(Name="Valid", GroupName="ValidationStates")]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="TextElement", Type=System.Windows.Controls.TextBlock)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardFocused")]
[TemplatePartAttribute(Name="HeadersPresenter", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InputElement", Type=Intersoft.Client.UI.Controls.UXTextBox)]
[TemplatePartAttribute(Name="ContentPresenter", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplateVisualStateAttribute(GroupName="KeyboardFocusStates", Name="KeyboardUnfocused")]
[TemplatePartAttribute(Name="PopupElement", Type=Intersoft.Client.UI.Controls.UXPopup)]
[TemplatePartAttribute(Name="NonEditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="EditableElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="StatusElement", Type=System.Windows.Controls.Grid)]
[DescriptionAttribute("Represents a multiple selection combo box control.")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidUnfocused")]
[TemplateVisualStateAttribute(GroupName="ValidationStates", Name="InvalidFocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarVisible")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="HighlightFocused")]
[TemplatePartAttribute(Name="SelectionInputElement", Type=Intersoft.Client.UI.Data.SelectionInputControl)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Unfocused")]
[TemplateVisualStateAttribute(GroupName="StatusBarStates", Name="StatusBarCollapsed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")]
[TemplatePartAttribute(Name="MoreButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplatePartAttribute(Name="ClearButtonElement", Type=System.Windows.Controls.Primitives.ButtonBase)]
[TemplateVisualStateAttribute(GroupName="FocusStates", Name="Focused")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="Pressed")]
[TemplateVisualStateAttribute(GroupName="CommonStates", Name="MouseOver")]
public ref class UXMultipleSelectionComboBox : public UXDataComboBox, IControl, IFramework, ILicensing, IMultipleSelection, IFocusRedirection, IKeyboardFocus, ISelection 

Example

The following code shows how to use UXMultipleSelectionComboBox control in single column.

XAML Copy Code 
<Intersoft:UXMultipleSelectionComboBox SearchResult="{Binding Customers}"
        FilterDescriptors="{Binding LookUpDescriptor.FilterDescriptors, Mode=TwoWay}" 
        SortDescriptors="{Binding LookUpDescriptor.SortDescriptors, Mode=TwoWay}" 
        PageDescriptor="{Binding LookUpDescriptor.PageDescriptor}" 
        DisplayMemberPath="ContactName"> 
        <Intersoft:UXMultipleSelectionComboBox.DataContext> 
                <ViewModels:CustomerViewModel/> 
        </Intersoft:UXMultipleSelectionComboBox.DataContext> 
</Intersoft:UXMultipleSelectionComboBox>
Notice that if you use the paging feature, you need to do special handling in your ViewModel. See UXPageableComboBox to learn how to handle this behavior.

To enable multiple columns feature, simply add the following code to your UXMultipleSelectionComboBox control markup.

XAML Copy Code 
<Intersoft:UXMultipleSelectionComboBox.Columns> 
        <Intersoft:UXDataComboBoxTextColumn Header="Customer ID" Binding="{Binding CustomerID}"
                DisplayMode="Image" ImageHeight="64" ImageWidth="64" ImageStretch="Fill" ImageBinding="{Binding PhotoPath}"/> 
        <Intersoft:UXDataComboBoxTextColumn Header="Contact Name" Binding="{Binding ContactName}"/>
        <Intersoft:UXDataComboBoxTextColumn Header="Company Name" Binding="{Binding CompanyName}"/>
        <Intersoft:UXDataComboBoxTextColumn Header="Country" Binding="{Binding Country}"/> 
</Intersoft:UXMultipleSelectionComboBox.Columns>

To learn more about Columns in UXMultipleSelectionComboBox, see UXPageableComboBox Columns Overview.

Remarks

UXMultipleSelectionComboBox is a queryable combo box control derived from the UXDataComboBox which is specially designed to support multiple selection. All features in UXPageableComboBox, such as multiple column, sorting, and paging feature, are also supported in this control. To learn more about these features, see UXDataComboBox Overview and UXPageableComboBox Overview.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ItemsControl
                  Intersoft.Client.Framework.ISItemsControl
                     Intersoft.Client.Framework.ISSelectionControl
                        Intersoft.Client.UI.Aqua.UXCollection.UXComboBox
                           Intersoft.Client.UI.Data.UXDataComboBox
                              Intersoft.Client.UI.Data.UXMultipleSelectionComboBox

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.