[This documentation is preliminary and is subject to change.]
Provides UI controls and classes that support existing and custom controls.
Members
The Windows.UI.Xaml.Controls namespace has these types of members:
Classes
The Windows.UI.Xaml.Controls namespace has these classes.
| Class | Description |
|---|---|
| AppBar | Represents the container control that holds app UI components for commanding and experiences. |
| Border | Draws a border, background, or both around another object. |
| Button | Represents a templated button control that interprets a Click user interaction. |
| Canvas | Defines an area within which you can explicitly position child objects, using coordinates that are relative to the Canvas area. |
| CaptureElement | Renders a stream from a capture device, such as a camera or webcam. |
| CheckBox | Represents a control that a user can select (check) or clear (uncheck). A CheckBox can also reports its value mode as indeterminate. |
| CleanUpVirtualizedItemEventArgs | Provides data for the CleanUpVirtualizedItemEvent event. |
| ColumnDefinition | Defines column-specific properties that apply to Grid objects. |
| ColumnDefinitionCollection | Provides access to an ordered, strongly typed collection of ColumnDefinition objects. |
| ComboBox | Represents a selection control that combines a non-editable text box and a drop-down list box that allows users to select an item from a list. |
| ComboBoxItem | Represents a selectable item contained in a ComboBox control. |
| ContentControl | Represents a control with a single piece of content. Controls such as Button, CheckBox, and ScrollViewer directly or indirectly inherit from this class. |
| ContentPresenter | Displays the content of a ContentControl. |
| ContextMenuEventArgs | Provides event data for the ContextMenuOpening event that exists on several text-related UI elements. |
| Control | Represents the base class for UI elements that use a ControlTemplate to define their appearance. |
| ControlTemplate | Defines the element tree that is applied as the control template for a control. |
| DataTemplateSelector | Enables custom template selection logic at the application level. |
| DragItemsStartingEventArgs | Provides event data for the DragItemsStarting event. |
| FlipView | Represents an items control that displays one item at a time, and which enables "flip" behavior for traversing its collection of items. |
| FlipViewItem | Represents the items wrapper class for a FlipView control. |
| Frame | Represents a content control that supports navigation. |
| Grid | Defines a flexible grid area that consists of columns and rows. Child elements of the Grid are measured and arranged according to their row/column assignments and internal class logic. |
| GridView | Represents a specialized ordered list view. |
| GridViewItem | Represents an item in a GridView control. |
| GroupItem | Represents the root element for a subtree that is created for a group. |
| GroupStyle | Describes how to display the grouped items in a collection, such as the collection from GroupItems. |
| GroupStyleSelector | A class that you derive from to select the group style as a function of the parent group and its level. |
| HyperlinkButton | Represents a button control that displays a hyperlink. |
| Image | Represents a control that displays an image. The image is specified as an image file in several possible formats, see Remarks. |
| ItemClickEventArgs | Provides event data for the ItemClick event. |
| ItemCollection | Holds the list of items that represent the content of an ItemsControl. |
| ItemContainerGenerator | Provides mappings between the items of an ItemsControl and their container elements. |
| ItemsControl | Represents a control that can be used to present a collection of items. |
| ItemsPanelTemplate | Specifies the panel that the ItemsPresenter creates for the layout of the items of an ItemsControl. |
| ItemsPresenter | Specifies where items are placed in a control, usually an ItemsControl. |
| ListBox | Contains a list of selectable items. |
| ListBoxItem | Represents a selectable item in a ListBox control. |
| ListView | Represents a control that displays a list of data items. |
| ListViewBase | Provides the infrastructure for the ListViewclass or for related classes likeGridView. |
| ListViewItem | Represents an item in a ListView control. |
| MediaElement | Represents an object that contains audio, video, or both. |
| NotifyEventArgs | Provides data for the ScriptNotify event. |
| Page | Encapsulates a page of content that can be navigated to. |
| Panel | Provides a base class for all Panel elements. Use Panel elements to position and arrange child objects in a UI page. |
| PasswordBox | Represents a control for entering passwords. |
| ProgressBar | Represents a control that indicates the progress of an operation, where the typical visual appearance is a bar that animates a filled area as progress continues. |
| ProgressRing | Represents a control that indicates that an operation is ongoing. The typical visual appearance is a ring-shaped "spinner" that cycles an animation as progress continues. |
| RadioButton | Represents a button that allows a user to select a single option from a group of options. |
| RichEditBox | Represents a rich text editing control that supports formatted text, hyperlinks, and other rich content. |
| RichTextBlock | Represents a rich text display container that supports formatted text, hyperlinks, inline images, and other rich content. Also, RichTextBlock supports a built-in overflow model. |
| RichTextBlockOverflow | Represents a rich text display overflow container. This element cannot have direct content. The only purpose of RichTextBlockOverflow is to display text content that does not fit in the bounds of a RichTextBlock or another RichTextBlockOverflow element. |
| RowDefinition | Defines row-specific properties that apply to Grid elements. |
| RowDefinitionCollection | Provides access to an ordered, strongly typed collection of RowDefinition objects. |
| ScrollContentPresenter | Displays the content of a ScrollViewer control. |
| ScrollViewer | Represents a scrollable area that can contain other visible elements. |
| ScrollViewerViewChangedEventArgs | Provides event data for the ViewChanged event and similar control-specific events. |
| SelectionChangedEventArgs | Provides data for the SelectionChanged event. |
| SemanticZoom | Represents a scrollable control that incorporates two views that have a semantic relationship. For example, the ZoomedOutView might be an index of titles, and the ZoomedInView might include details and summaries for each of the title entries. Views can be changed using zoom or other interactions. |
| SemanticZoomLocation | Communicates information for items and view state in a SemanticZoom, such that hosts for scrolling and virtualization (such as ListViewBase) can get correct item and bounds information. |
| SemanticZoomViewChangedEventArgs | Provides event data for the ViewChangeStarted and ViewChangeCompleted events. |
| Slider | Represents a control that lets the user select from a range of values by moving a Thumb control along a track. |
| StackPanel | Arranges child elements into a single line that can be oriented horizontally or vertically. |
| StyleSelector | A class that you derive from to select the item style as a function of the content data and its specific item container. |
| SwapChainBackgroundPanel | Implements a XAML layout surface target for Microsoft DirectX interoperation scenarios. This panel has some atypical restrictions on its usage within an app window; see Remarks. |
| TextBlock | Provides a lightweight control for displaying small amounts of text. |
| TextBox | Represents a control that can be used to display single-format, multi-line text. |
| TextChangedEventArgs | Provides data for the TextChanged event. |
| ToggleSwitch | Represents a switch that can be toggled between two states. |
| ToolTip | Represents a control that creates a pop-up window that displays information for an element in the UI. |
| ToolTipService | Represents a service that provides static methods to display a tooltip. |
| UIElementCollection | Represents an ordered collection of UIElement objects. |
| UserControl | Provides the base class for defining a new control that encapsulates related existing controls and provides its own logic. |
| VariableSizedWrapGrid | Provides a grid-style layout panel where each tile/cell can be variable size based on content. |
| Viewbox | Defines a content decorator that can stretch and scale a single child to fill the available space. |
| VirtualizingPanel | Provides a framework for Panel elements that virtualize their visual children. |
| VirtualizingStackPanel | Arranges and virtualizes content on a single line that is oriented either horizontally or vertically. |
| WebView | Provides a UI element that hosts HTML content within the application. |
| WebViewBrush | Provides a brush that renders the content that is currently hosted in a WebView control. |
| WebViewNavigationFailedEventArgs | Provides data for the WebView.NavigationFailed event. |
| WrapGrid | Positions child elements sequentially from left to right or top to bottom. When elements extend beyond the container edge, elements are positioned in the next row or column. |
Delegates
The Windows.UI.Xaml.Controls namespace has these delegates.
| Delegate | Description |
|---|---|
| CleanUpVirtualizedItemEventHandler | Represents the method that handles the CleanUpVirtualizedItemEvent attached events. |
| ContextMenuOpeningEventHandler | Represents the method that will handle the ContextMenuOpening event that exists on several text-related UI elements. |
| DragItemsStartingEventHandler | Represents the method that will handle the DragItemsStarting event. |
| ItemClickEventHandler | Represents the method that will handle an ItemClick event. |
| NotifyEventHandler | Represents the method that will handle the ScriptNotify event. |
| SelectionChangedEventHandler | Represents the method that will handle the SelectionChanged event. |
| SemanticZoomViewChangedEventHandler | Represents the method that will handle the ViewChangeStarted and ViewChangeCompleted events. |
| TextChangedEventHandler | Represents the method that will handle the TextChanged event. |
| WebViewNavigationFailedEventHandler | Represents the method that will handle the WebView.NavigationFailed event. |
Enumerations
The Windows.UI.Xaml.Controls namespace has these enumerations.
| Enumeration | Description |
|---|---|
| ClickMode | Specifies when the Click event should be raised for a control. |
| IncrementalLoadingTrigger | Specifies a value for list view incremental loading behavior (IncrementalLoadingTrigger property). |
| ListViewSelectionMode | Describes the current condition of selection in a list or a list view. |
| Orientation | Defines the different orientations that a control or layout can have. |
| ScrollBarVisibility | Specifies the visibility of a scrollbar within a ScrollViewer control. |
| ScrollIntoViewAlignment | Defines constants that describe how an item that is programmatically scrolled into view aligns with the visible area. |
| ScrollMode | Declares scrolling behavior for ScrollViewer and other parts involved in scrolling scenarios. |
| SelectionMode | Defines the selection behavior for a ListBox. |
| SnapPointsType | Indicates how zoom snap points are processed for gesture/manipulation input. |
| StretchDirection | Describes the direction that content is scaled. |
| VirtualizationMode | Specifies the method the VirtualizingStackPanel uses to manage virtualizing its child items. |
| ZoomMode | Indicates the current mode for zoom behavior in the ScrollViewer content. |
Interfaces
The Windows.UI.Xaml.Controls namespace implements these interfaces.
| Interface | Description |
|---|---|
| INavigate | Defines the navigation action for navigation hosts and navigation initiators. |
| ISemanticZoomInformation | Communicates the info needed for a list view to serve as one of the two possible views (ZoomedOutView or ZoomedInView) of a SemanticZoom. |
Requirements
|
Minimum supported client | Windows 8 Release Preview |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
Build date: 5/22/2012
