IXRComboBox (Compact 2013)
3/28/2014
This class represents a selection control that combines a non-editable text box and a drop-down list in which users select an item.
Syntax
class IXRComboBox : public IXRSelector
Inheritance Hierarchy
IXRComboBox
Methods
Method |
Description |
|---|---|
Attaches a delegate to the DropDownOpened event for this combo box. When the combo box raises the DropDownOpened event, this delegate will be invoked. |
|
Attaches a delegate to the DropDownClosed event for this combo box. When the combo box raises the DropDownClosed event, this delegate will be invoked. |
|
Retrieves a value that indicates whether the popup part of this combo box is currently open. |
|
Retrieves a value that indicates whether the user can edit text in the text-box part of this combo box. This method always returns false. |
|
Retrieves a value that indicates whether the item displayed in the selection box is highlighted. |
|
Retrieves the style that is used when XAML for Windows Embedded renders the item containers. |
|
Retrieves the maximum height of the popup that lists combo-box items. |
|
Retrieves the item displayed in the selection box. |
|
Removes a delegate to the DropDownOpened event for this combo box. When the combo box raises the DropDownOpened event, this delegate will be invoked. |
|
Removes a delegate to the DropDownClosed event for this combo box. When the combo box raises the DropDownClosed event, this delegate will be invoked. |
|
Sets a value that indicates whether the popup part of the combo box is currently open. |
|
Sets the style that is used when XAML for Windows Embedded renders the item containers. |
|
Sets the maximum height of the popup that lists combo-box items. |
Thread Safety
Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.
Remarks
The text box that belongs to this combo box either displays the current selection or is empty if there is no selected item.
IXRComboBox contains a collection of items. The items are visible in a drop-down menu that is displayed as a popup when it is opened. IXRComboBox inherits from IXRItemsControl, and you can retrieve its IXRItemCollection object by calling IXRItemsControl::GetItems. The items collection stores each object that represents a selectable item displayed in the list. Items in this collection can be IXRComboBoxItem objects.
The method IXRComboBox::SetItemContainerStyle enables you to define a visual appearance for the items in this combo box by supplying an IXRStyle object.
The attached properties ScrollViewer.HorizontalScrollBarVisibility and ScrollViewer.VerticalScrollBarVisibility are used to indicate whether a vertical or horizontal scrollbar should be displayed so that the user can scroll the list in the popup. This is ideal if only some items in the popup are visible in the graphical window and you want to provide a scrollbar. To add scrolling properties, you can add a property setter for one of these attached properties to the IXRStyle object that you supply in the call to SetItemContainerStyle. Or, you can call the inherited method IXRDependencyObject::SetAttachedProperty(const WCHAR*, const WCHAR*, int).
If you are not using a control template for this combo box, you can retrieve the item that is currently displayed in the non-editable text box by calling the inherited method IXRSelector::GetSelectedItem, and you can set the item to display in this text box by calling IXRSelector::SetSelectedItem.
When you create a class instance, use an IXRComboBoxPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.
You can also define a combo box in Microsoft Silverlight 3 XAML. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the ComboBox Class on MSDN.
.NET Framework Equivalent
System.Windows.Controls.ComboBox
Requirements
Header |
XamlRuntime.h |
sysgen |
SYSGEN_XAML_RUNTIME |