Items Controls

Items controls display collections of child controls. These controls have inherent behaviors that manage the appearance of their child controls.

Items controls can contain strings or any other control; for example, a list box can contain a radio button. Often an items control is used with a specific child control; for example, a tab control contains tab items.

The following sections describe the controls available in the Items Controls list.

Items Controls Property Usage

The following table shows the properties used by each control:


Property	Combo Box	Combo Item [add]	Group Box	Items Control	List Box	List Box Item [add]	List View	List View Item [add]	Menu	Menu Item [add]	Separator	Status Bar	Status Bar Item [add]	Tab	Tab Item [add]	Tool Bar	Tool Bar Tray	Tree View	Tree View Item [add]
AllowDrop	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
AlternationCount					X		X		X	X		X		X		X		X	X
Background	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Band																X
BandIndex																X
BorderBrush	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
BorderThickness	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
CacheMode				X
CharacterSpacing				X
Clip				X
ClipToBounds	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Column	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
ColumnSpan	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
CommandParameter										X
CommandTarget										X
Content		X	X			X		X					X		X
ContentStringFormat		X	X			X		X					X	X	X
Cursor				X
DataContext				X
DisplayMemberPath	X			X	X		X		X	X		X		X		X		X	X
Effect	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FlowDirection	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Focusable	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FocusVisualStyle	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontFamily	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontSize	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontStretch	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontStyle	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontWeight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
ForceCursor	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Foreground	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
Header			X							X					X	X			X
HeaderStringFormat			X							X					X	X			X
Height	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
HorizontalAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
HorizontalContentAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
Icon										X
InputGestureText										X
IsCheckable										X
IsChecked										X
IsDropDownOpen	X
IsEditable	X
IsEnabled	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsExpanded																			X
IsHitTestVisible	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsLocked																	X
IsMainMenu									X
IsManipulationEnabled	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsOverflowOpen																X
IsReadOnly	X
IsSelected		X				X		X							X				X
IsSharedSizeScope	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsSubmenuOpen										X
IsSynchronizedWithCurrentItem	X				X		X							X
IsTabStop	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
IsTextSearchCaseSensitive	X				X				X	X		X		X		X		X	X
IsTextSearchEnabled	X				X				X	X		X		X		X		X	X
ItemPanel				X
Items	X
ItemsSource	X			X	X		X		X	X		X		X		X		X	X
ItemStringFormat	X				X		X		X	X		X		X		X		X	X
ItemTemplate				X
Language				X
Localization	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Margin	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X
MaxDropDownHeight	X
MaxHeight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MaxWidth	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MinHeight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MinWidth	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Name	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Opacity	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
OpacityMask	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
OverridesDefaultStyle	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Padding	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
Projection				X
RenderTransformOrigin	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Row	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
RowSpan	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
SelectedIndex	X				X		X							X
SelectedItem					X		X							X
SelectedValue	X				X		X							X
SelectedValuePath	X				X		X							X				X	X
SnapsToDevicePixels		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
StaysOpenOnClick										X			X		X
StaysOpenOnEdit	X
Style	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
TabIndex	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
TabNavigation				X
TabStripPlacement														X
Tag	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Template	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
Text	X
ToolTip	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Uid	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
UseLayoutRounding	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
VerticalAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
VerticalContentAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X
Visibility	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Width	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X

Items Controls Property Descriptions

The following table shows the properties descriptions used by all control:

Property	Description
AllowDrop	Select this check box to indicate that the control can accept data that is dragged onto it.
AlternationCount	Specifies the number of alternating item containers or rows to display.
Background	Expand this field to select the background color of the selected control.
Band	Specifies where the toolbar should be located in the toolbar tray.
BandIndex	Specifies the band index number that indicates the position of the toolbar on the band.
BorderBrush	Expand this field to select the border color of the selected control.
BorderThickness	Specifies the border thickness of a control, in pixels.
CacheMode	Specifies a value that indicates that rendered content should be cached when possible.
CharacterSpacing	Specifies the distance between characters of text in the contol, measured in 1000ths of the font size.
Clip	Specifies the geometric shape used to define the outline of the image. Selections are: Hover Press Release
ClipToBounds	Select this check box to clip the content of this control (or content coming from the child elements of this control) to fit into the size of the containing control.
Column	Specifies the column within the grid where the control is located.
ColumnSpan	Specifies the total number of columns that child content spans within a grid.
CommandParameter	Specifies the parameter to pass to the Command property.
CommandTarget	Specifies the element on which to raise the specified command.
Content	Specifies the content displayed on the control.
ContentStringFormat	Specifies a composite string that determines how to format the Content property if it is displayed as a string.
Cursor	Specifies the cursor image to display when the mouse pointer hovers over an object.
DataContext	Specifies the data context for a control when it participates in data binding.
DisplayMemberPath	Specifies a path to a value on the source control to serve as the visual representation of the control.
Effect	Click the arrow to expand the property, select the effect you want to apply to the control, and then configure the specific values for the effect. Valid values to select are: Blur Kernel Type Radius Drop Shadow Color Direction Opactiy Shadow Depth
FlowDirection	Specifies the direction that text and other user interface (UI) elements flow within any parent control. Selections are: Left to Right Right to Left
Focusable	Select this check box to indicate that the control can receive focus.
FocusVisualStyle	Specifies a property that enables customization of appearance, effects, or other style characteristics that apply to this control when it has focus.
FontFamily	Specifies the font family for the control.
FontSize	Specifies the font size for the control.
FontStretch	Specifies the degree to which a font is condensed or expanded on the screen.
FontStyle	Specifies the font style for the control.
FontWeight	Specifies the weight or thickness of the specified font.
ForceCursor	Select this check box to indicate that the user interface (UI) renders the cursor as declared by the Cursor property.
Foreground	Expand this field to select the foreground color.
Header	Specifies the header text to display on the control.
HeaderStringFormat	Specifies a composite string that indicates how to format the header if it is displayed as a string
Height	Specifies the height of the control, in pixels.
HorizontalAlignment	Specifies the horizontal alignment characteristics applied to this control. Selections are: Left Center Right Stretch
HorizontalContentAlignment	Specifies the horizontal alignment of the control's content. Selections are: Left Center Right Stretch
Icon	Specifies the icon that displays for a Menu Item.
ImageStretch	Specifies how the image should be stretched to fill the destination rectangle. Selections are: Fill None Uniform UniformToFill
IsCheckable	Select this check box to indicate that a Menu Item can be checked by default.
IsChecked	Select this check box to indicate that the control is checked.
IsDropDownOpen	Select this check box to indicate that the drop-down area for a combo box is open.
IsEditable	Select this check box to indicate that the text in the Combo Box can be edited.
IsEnabled	Select this check box to indicate that this control is enabled in the user interface (UI).
IsExpanded	Select this check box to indicate that the expander content window is visible.
IsHitTestVisible	Select this check box to indicate that the control can possibly be returned as a hit test result from some portion of its rendered content.
IsLocked	Select this check box to indicate that a Tool Bar control cannot be moved inside a Tool Bar Tray.
IsMainMenu	Specifies whether the menu control gains focus if the F10 or Alt key is pressed on the keyboard. If there are multiple menu controls in a form, then only one of the controls should have its check box selected; the IsMainMenu property check box for the other menu control(s) should be cleared.
IsManipulationEnabled	Select this check box to indicate that the manipulation events for the control are enabled.
IsOverflowOpen	Select this check box to indicate that the Tool Bar overflow area is visible.
IsReadOnlyCaretVisible	Specifies whether a read-only text box displays a caret. If the IsReadOnly check box is selected, you can still select and copy text. If the IsReadOnlyCaretVisible check box is also selected, a caret appears in the text box when the text box has keyboard focus. When the IsReadOnly check box is cleared, selecting the IsReadOnlyCaretVisible check box has no effect.
IsSelected	Select this check box to indicate that the item is selected.
IsSharedSizeScope	Select this check box to indicate that controls are sharing size information.
IsSubmenuOpen	Select this check box to indicate that the submenu of the Menu Item is open.
IsSynchronizedWithCurrentItem	Select this check box to indicate that a selector should keep the selected item synchronized with the current item in the Items property.
IsTabStop	Select this check box to indicate that a control is included in tab navigation.
IsTextSearchCaseSensitive	Select this check box to indicate that text searches are case sensitive.
IsTextSearchEnabled	Select this check box to indicate that text search is enabled on the control.
ItemPanel	Specifies the template that defines the panel that controls the layout of items.
Items	Specifies the collection used to generate the content of the control.
ItemsSource	Specifies the collection used to generate the content of the control.
ItemStringFormat	Specifies a composite string that determines how to format the items in the control if they are displayed as strings.
ItemTemplate	Click the ellipsis button to open the Open dialog box to select the data template used to display each item.
Language	Specifies the localization language that applies to an object.
Localization	Click the ellipsis button to open the Localization Configuration dialog box where you can configure the property to localize, the language to use for localization, and the text to localize.
Margin	Specifies the outer margin of a control.
MaxDropDownHeight	Specifies the maximum height for a combo box drop-down.
MaxHeight	Specifies the maximum height of a control.
MaxWidth	Specifies the maximum width of a control.
MinHeight	Specifies the minimum height of a control.
MinWidth	Specifies the minimum width of a control.
Name	Specifies the identifying name of the control. The name provides a reference so that code behind, such as event handler code, can refer to a markup element during processing by a XAML processor.
Opacity	Specifies the opacity factor applied to the entire control. Valid values are 0 through 1, with up to 15 decimal places.
OpacityMask	Expand this field to select a color for the opacity mask, which is applied to any alpha-channel masking for the rendered content of this control.
OverridesDefaultStyle	Select this check box to indicate that this control incorporates style properties from theme styles.
Padding	Specifies the amount of padding to apply to the inside edge of each side of a control.
Projection	Specifies the 3-D effect to apply to the current object.
RenderTransformOrigin	Specifies the center point of any possible render transform, relative to the bounds of the element. X is the horizontal origin factor, given as a value between 0 and 1. Y is the vertical origin factor, given as a value between 0 and 1.
Row	RowBackground
RowSpan	Specifies the total number of rows that child content spans within a grid.
SelectedIndex	Specifies the index of the first item in the current selection, or returns negative one (-1) if the selection is empty.
SelectedItem	Specifies the first item in the current selection or returns null if the selection is empty.
SelectedValue	Specifies the value of the SelectedItem property, obtained by using the SelectedValuePath property.
SelectedValuePath	Specifies the path that is used to get the SelectedValue property from the SelectedItem property.
SnapsToDevicePixels	Select this check box to indicate that rendering for this control uses device-specific pixel settings.
StaysOpenOnEdit	Select this check box to indicate that a Combo Box that is open and displaying a drop-down control, remains open when you click in the text box.
Style	Specifies the style used by this control when it is rendered.
TabIndex	Specifies the order in which controls receive focus when the Tab key is pressed.
TabNavigation	Specifies a value that modifies how tabbing and the TabIndex property work for this control.
TabStripPlacement	Specifies how tab headers align relative to the tab content. Selections are: Top Right Bottom
Tag	Specifies an arbitrary object value that can be used to store custom information about this control.
Template	Click the ellipsis button to open the Open dialog box to select a template to use.
Text	Specifies the text contents of a control.
ToolTip	Specifies the tool-tip that displays for this control in the user interface (UI).
Uid	Specifies the unique identifier (for localization) for this control.
UseLayoutRounding	Specifies a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels.
VerticalAlignment	Specifies the vertical alignment characteristics applied to this control. Selections are: Bottom Center Top Stretch
VerticalContentAlignment	Specifies the vertical alignment of the control's content. Selections are: Bottom Center Top Stretch
Visiblility	Specifies the visibility of this control. Selections are: Collapsed Hidden Visible
Width	Specifies the width of the control, in pixels.