Microsoft.UI.Xaml.Controls Namespace

Provides UI controls and classes for creating custom controls.

Classes

AnchorRequestedEventArgs

Provides data for the ScrollViewer.AnchorRequested event.

AnimatedIcon

Represents an icon that displays and controls a visual that can animate in response to user interaction and visual state changes.

AnimatedIconSource

Represents a shareable object used to create an icon that displays and controls a visual that can animate in response to user interaction and visual state changes.

AnimatedVisualPlayer

An element that displays and controls an IAnimatedVisual.

AnnotatedScrollBar

Represents a control that enables vertical scrolling of content with navigation to labeled positions at definable increments.

AnnotatedScrollBarDetailLabelRequestedEventArgs

Provides data for the AnnotatedScrollBar.DetailLabelRequested event.

AnnotatedScrollBarLabel

Represents the content and scroll offset value of a label that is to be displayed by the AnnotatedScrollBar.

AnnotatedScrollBarScrollingEventArgs

Provides data for the AnnotatedScrollBar.Scrolling event.

AppBar

Represents the container control that holds app UI components for commanding and experiences.

AppBarButton

Represents a templated button control to be displayed in an AppBar.

AppBarElementContainer

Represents a container that allows an element that doesn't implement ICommandBarElement to be displayed in a command bar.

AppBarSeparator

Represents a line that separates items in an AppBar or CommandBar.

AppBarToggleButton

Represents a button control that can switch states and be displayed in an AppBar.

AutoSuggestBox

Represents a text control that makes suggestions to users as they enter text using a keyboard or pen (using ink and handwriting recognition). The app is notified when text has been changed by the user and is responsible for providing relevant suggestions for this control to display.

AutoSuggestBoxQuerySubmittedEventArgs

Provides event data for the AutoSuggestBox.QuerySubmitted event.

AutoSuggestBoxSuggestionChosenEventArgs

Provides data for the SuggestionChosen event.

AutoSuggestBoxTextChangedEventArgs

Provides data for the TextChanged event.

BitmapIcon

Represents an icon that uses a bitmap as its content.

BitmapIconSource

Represents an icon source that uses a bitmap as its content.

Border

Draws a border, background, or both, around another object.

BreadcrumbBar

The BreadcrumbBar control provides the direct path of pages or folders to the current location.

BreadcrumbBarItem

Represents an item in a BreadcrumbBar control.

BreadcrumbBarItemClickedEventArgs

Provides data for the BreadcrumbBar.ItemClicked event.

Button

Represents a templated button control that interprets a Click user interaction.

CalendarDatePicker

Represents a control that allows a user to pick a date from a calendar display.

CalendarDatePickerDateChangedEventArgs

Provides event data for the DateChanged event.

CalendarView

Represents a control that enables a user to select a date by using a visual calendar display.

CalendarViewDayItem

Represents a day on a CalendarView.

CalendarViewDayItemChangingEventArgs

Provides data for the CalendarViewDayItemChanging event.

CalendarViewSelectedDatesChangedEventArgs

Provides data for the SelectedDatesChanged event.

CandidateWindowBoundsChangedEventArgs

Provides event data for the CandidateWindowBoundsChanged event.

Canvas

Defines an area within which you can explicitly position child objects, using coordinates that are relative to the Canvas area.

CheckBox

Represents a control that a user can select (check) or clear (uncheck). A CheckBox can also report its value as indeterminate.

ChoosingGroupHeaderContainerEventArgs

Provides event data for the ListViewBase.ChoosingGroupHeaderContainer event.

ChoosingItemContainerEventArgs

Provides event data for the ListViewBase.ChoosingItemContainer event.

CleanUpVirtualizedItemEventArgs

Provides data for the CleanUpVirtualizedItemEvent event.

ColorChangedEventArgs

Provides event data for a ColorChanged event (see ColorPicker.ColorChanged and ColorSpectrum.ColorChanged).

ColorPicker

Represents a control that lets a user pick a color using a color spectrum, sliders, or text input.

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 the container for an item in a ComboBox control.

ComboBoxTextSubmittedEventArgs

Provides data when the user enters custom text into the ComboBox.

CommandBar

Represents a specialized app bar that provides layout for AppBarButton and related command elements.

CommandBarFlyout

Represents a specialized flyout that provides layout for AppBarButton, AppBarToggleButton, and AppBarSeparator controls.

CommandBarOverflowPresenter

Displays the overflow content of a CommandBar.

ContainerContentChangingEventArgs

Provides data for the ContainerContentChanging event.

ContentControl

Represents a control with a single piece of content. Controls such as Button, CheckBox, and ScrollViewer directly or indirectly inherit from this class.

ContentDialog

Represents a dialog box that can be customized to contain checkboxes, hyperlinks, buttons and any other XAML content.

ContentDialogButtonClickDeferral

Represents a deferral that can be used by an app to respond asynchronously to a button click event.

ContentDialogButtonClickEventArgs

Provides data for the button click events.

ContentDialogClosedEventArgs

Provides data for the Closed event.

ContentDialogClosingDeferral

Represents a deferral that can be used by an app to respond asynchronously to the closing event of the ContentDialog.

ContentDialogClosingEventArgs

Provides data for the closing event.

ContentDialogOpenedEventArgs

Provides data for the Opened event.

ContentPresenter

Displays the content of a ContentControl. Can also provide content presentation for non-controls. Provides a base class for specialized presenters such as ScrollContentPresenter.

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. Parent class for ContentControl, UserControl, ItemsControl and several practical controls.

ControlTemplate

Defines the element tree that is used as the control template for a control.

CoreWebView2InitializedEventArgs

Provides data for the CoreWebView2Initialized event.

DataTemplateSelector

Enables custom template selection logic at the application level.

DatePickedEventArgs

Provides data for the DatePicked event.

DatePicker

Represents a control that allows a user to pick a date value.

DatePickerFlyout

Represents a control that allows a user to pick a date.

DatePickerFlyoutItem

Represents the container for an item in the DatePickerFlyout control.

DatePickerFlyoutPresenter

Represents a control to allow a user to pick a date.

DatePickerSelectedValueChangedEventArgs

Provides event data for the DatePicker.SelectedDateChanged event.

DatePickerValueChangedEventArgs

Provides event data for the DatePicker.DateChanged event.

DragItemsCompletedEventArgs

Provides event data for the DragItemsCompleted event.

DragItemsStartingEventArgs

Provides event data for the DragItemsStarting event.

DropDownButton

Represents a button that includes a chevron to indicate a menu can be opened.

DynamicOverflowItemsChangingEventArgs

Provides data for the CommandBar.DynamicOverflowItemsChanging event.

ElementFactoryGetArgs

Represents the optional arguments to use when calling an implementation of the GetElement method of an IElementFactory object.

ElementFactoryRecycleArgs

Represents the optional arguments to use when calling an implementation of the RecycleElement method of an IElementFactory object.

Expander

Represents a control that displays a header and has a collapsible body that displays content.

ExpanderCollapsedEventArgs

Provides data for the Expander.Collapsed event.

ExpanderExpandingEventArgs

Provides data for the Expander.Expanding event.

ExpanderTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for an Expander. Not intended for general use.

FlipView

Represents an items control that displays one item at a time, and enables "flip" behavior for traversing its collection of items.

FlipViewItem

Represents the container for an item in a FlipView control.

Flyout

Represents a control that displays lightweight UI that is either information, or requires user interaction. Unlike a dialog, a Flyout can be light dismissed by clicking or tapping outside of it, pressing the device's back button, or pressing the 'Esc' key.

FlyoutPresenter

Displays the content of a Flyout.

FocusDisengagedEventArgs

Provides data for the FocusDisengaged event.

FocusEngagedEventArgs

Provides data for the FocusEngaged event.

FontIcon

Represents an icon that uses a glyph from the specified font.

FontIconSource

Represents an icon source that uses a glyph from the specified font.

Frame

Displays Page instances, supports navigation to new pages, and maintains a navigation history to support forward and backward 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 (set by using Grid.Row and Grid.Column attached properties) and other logic.

GridView

Represents a control that displays data items in rows and columns.

GridViewHeaderItem

Represents items in the header for grouped data inside a GridView.

GridViewItem

Represents the container for 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

Enables custom group style selection logic as a function of the parent group and its level.

HasValidationErrorsChangedEventArgs

Contains event data for validation control error changes.

Hub

Represents a control that displays groups of content in a panning view.

HubSection

Represents a single group of content in a Hub.

HubSectionCollection

Represents an ordered collection of HubSection objects.

HubSectionHeaderClickEventArgs

Provides data for the Hub.SectionHeaderClick event.

HyperlinkButton

Represents a button control that functions as a hyperlink.

IconElement

Represents the base class for an icon UI element.

IconSource

Represents the base class for an icon source.

IconSourceElement

Represents an icon that uses an IconSource as its content.

Image

Represents a control that displays an image. The image source is specified by referring to an image file, using several supported formats. The image source can also be set with a stream. See Remarks for the list of supported image source formats.

ImageIcon

Represents an icon that uses an Image as its content.

ImageIconSource

Represents an icon source that uses an image type as its content. The image types currently supported are .bmp, .gif, .jpg, .png, .wdp, and .tiff.

InfoBadge

Represents a control for indicating notifications, alerts, new content, or to attract focus to an area within an app.

InfoBadgeTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for an InfoBadge.

InfoBar

An InfoBar is an inline notification for essential app-wide messages. The InfoBar will take up space in a layout and will not cover up other content or float on top of it. It supports rich content (including titles, messages, icons, and buttons) and can be configured to be user-dismissable or persistent.

InfoBarClosedEventArgs

Provides data for the InfoBar.Closed event.

InfoBarClosingEventArgs

Provides data for the InfoBar.Closing event.

InfoBarTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for an InfoBar.

InputPropertyAttribute

Represents an attribute that indicates which property of a type is the XAML input property. A XAML processor uses this information when processing XAML child elements of XAML representations of the attributed type.

IsTextTrimmedChangedEventArgs

Provides event data for the IsTextTrimmedChanged event.

ItemClickEventArgs

Provides event data for the ItemClick event.

ItemCollection

Holds the list of items that represent the content of an ItemsControl.

ItemCollectionTransition

Represents a single transition to be visually animated.

ItemCollectionTransitionCompletedEventArgs

Provides data for the TransitionCompleted event that is raised when a transition animation has completed.

ItemCollectionTransitionProgress

Represents a helper object associated with a transition that provides a method to notify that the transition's animations have completed.

ItemCollectionTransitionProvider

Represents an object that provides transition animations when the data collection changes in an ItemsRepeater-based collection control.

ItemContainer

Represents the container for an individual item in an ItemsView collection control.

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.

ItemsPickedEventArgs

Provides data for the ItemsPicked event.

ItemsPresenter

Specifies where items are placed in a control, usually an ItemsControl.

ItemsRepeater

Represents a data-driven collection control that incorporates a flexible layout system, custom views, and virtualization, with no default UI or interaction policies.

ItemsRepeaterElementClearingEventArgs

Provides data for the ItemsRepeater.ElementClearing event.

ItemsRepeaterElementIndexChangedEventArgs

Provides data for the ItemsRepeater.ElementIndexChanged event.

ItemsRepeaterElementPreparedEventArgs

Provides data for the ItemsRepeater.ElementPrepared event.

ItemsRepeaterScrollHost

A helper to coordinate interaction between the ItemsRepeater and ScrollViewer. Use the ItemsRepeaterScrollHost if your app will run on versions of Windows prior Windows 10 1809 (Build 17763). If your app will only run on versions of Windows 1809 or higher, there is no need to use this control.

ItemsSourceView

Represents a standardized view of the supported interactions between a given ItemsSource object and an ItemsRepeater control.

ItemsStackPanel

Arranges child elements of an ItemsControl into a single line that can be oriented horizontally or vertically. Supports pixel-based UI virtualization and grouped layouts.

ItemsView

Represents a control that displays data items. It can organize them using various layouts like vertical stacking or columns and rows.

ItemsViewItemInvokedEventArgs

Provides data for the ItemsView.ItemInvoked event.

ItemsViewSelectionChangedEventArgs

Provides data for the ItemsView.SelectionChanged event.

ItemsWrapGrid

Positions child elements sequentially from left to right or top to bottom in an ItemsControl that shows multiple items. When elements extend beyond the container edge, elements are positioned in the next row or column. Supports pixel-based UI virtualization and grouped layouts.

Layout

Represents the base class for an object that sizes and arranges child elements for a host.

LayoutContext

Represents the base class for an object that facilitates communication between an attached layout and its host container.

LinedFlowLayout

Represents a control that positions elements sequentially from left to right, then top to bottom, in a wrapping layout, using the same height for all elements.

LinedFlowLayoutItemCollectionTransitionProvider

Represents an object that provides transition animations specifically designed to look appealing when combined with LinedFlowLayout.

LinedFlowLayoutItemsInfoRequestedEventArgs

Provides data for the LinedFlowLayout.LayoutItemsInfoRequested event.

ListBox

Presents a list of items the user can select from.

ListBoxItem

Represents the container for an item in a ListBox control.

ListPickerFlyout

Represents a control that allows a user to pick one or more items from a list. See Remarks.

ListPickerFlyoutPresenter

Represents a control that allows a user to pick one or more items from a list. (Not recommended for Universal Windows Platform (UWP) app. See Flyout.)

ListView

Represents a control that displays data items in a vertical stack.

ListViewBase

Provides the infrastructure for the ListView and GridView classes.

ListViewBaseHeaderItem

Provides the infrastructure for the ListViewHeaderItem and GridViewHeaderItem classes.

ListViewHeaderItem

Represents items in the header for grouped data inside a ListView.

ListViewItem

Represents the container for an item in a ListView control.

ListViewPersistenceHelper

Represents a helper class to save and retrieve the relative scroll position of the ListView.

MapControl

Represents a symbolic map of the Earth.

MapControlMapServiceErrorOccurredEventArgs

Provides data for the MapControl.MapServiceErrorOccurred event.

MapElement

Represents an element displayed on a MapControl.

MapElementClickEventArgs

Provides data for MapElementClick events.

MapElementsLayer

Represents a collection of map elements to which you can bind data and manipulate independently of other map elements.

MapIcon

Represents an icon that displays a pushpin on a MapControl.

MapLayer

Represents a collection of map data to which you can bind data and manipulate independently of other types of map data.

MediaPlayerElement

Represents an object that uses a MediaPlayer to render audio and video to the display.

MediaPlayerPresenter

Represents an object that displays a MediaPlayer.

MediaTransportControls

Represents the playback controls for a media player element.

MediaTransportControlsHelper

Provides properties and methods to customize media transport controls.

MenuBar

Represents a specialized container that presents a set of menus in a horizontal row, typically at the top of an app window.

MenuBarItem

Represents a top-level menu in a MenuBar control.

MenuBarItemFlyout

Represents the flyout of a MenuBarItem.

MenuFlyout

Represents a flyout that displays a menu of commands.

MenuFlyoutItem

Represents a command in a MenuFlyout control.

MenuFlyoutItemBase

Represents the base class for items in a MenuFlyout control.

MenuFlyoutPresenter

Displays the content of a MenuFlyout control.

MenuFlyoutSeparator

Represents a horizontal line that separates items in an MenuFlyout.

MenuFlyoutSubItem

Represents a menu item that displays a sub-menu in a MenuFlyout control.

NavigationView

Represents a container that enables navigation of app content. It has a header, a view for the main content, and a menu pane for navigation commands.

NavigationViewBackRequestedEventArgs

Provides event data for the NavigationView.BackRequested event.

NavigationViewDisplayModeChangedEventArgs

Provides data for the NavigationView.DisplayModeChanged event.

NavigationViewItem

Represents the container for an item in a NavigationView control.

NavigationViewItemBase

Base class for NavigationView menu items.

NavigationViewItemCollapsedEventArgs

Provides event data for the NavigationViewItem.Collapsed event.

NavigationViewItemExpandingEventArgs

Provides event data for the NavigationViewItem.Expanding event.

NavigationViewItemHeader

Represents a header for a group of menu items in a NavigationView.

NavigationViewItemInvokedEventArgs

Provides event data for the NavigationView.ItemInvoked event.

NavigationViewItemSeparator

Represents a line that separates menu items in a NavigationView.

NavigationViewPaneClosingEventArgs

Provides data for the NavigationView.PaneClosing event.

NavigationViewSelectionChangedEventArgs

Provides data for the NavigationView.SelectionChanged event.

NavigationViewTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a NavigationView. Not intended for general use.

NonVirtualizingLayout

Represents the base class for an object that sizes and arranges child elements for a host and and does not support virtualization.

NonVirtualizingLayoutContext

Represents the base class for layout context types that do not support virtualization.

NumberBox

Represents a control that can be used to display and edit numbers.

NumberBoxValueChangedEventArgs

Provides event data for the NumberBox.ValueChanged event.

Page

Represents content that a Frame control can navigate to.

Panel

Provides a base class for all Panel elements. Use Panel elements to position and arrange child objects in a UI page.

ParallaxView

Represents a container that associates the scroll position of a foreground element, such as a list, with a background element, such as an image. A 3D effect is created from each element having a different scrolling rate.

PasswordBox

Represents a control for entering passwords.

PasswordBoxPasswordChangingEventArgs

Provides event data for the PasswordBox.PasswordChanging event.

PathIcon

Represents an icon that uses a vector path as its content.

PathIconSource

Represents an icon source that uses a vector path as its content.

PersonPicture

Represents a control that displays the avatar image for a person, if one is available; if not, it displays the person's initials or a generic glyph.

PersonPictureTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a PersonPicture control. Not intended for general use.

PickerConfirmedEventArgs

Provides data for the PickerConfirmed event.

PickerFlyout

Represents a custom picker control. (Not recommended for Universal Windows Platform (UWP) app. See Flyout.)

PickerFlyoutPresenter

Represents a custom picker. (Not recommended for Universal Windows Platform (UWP) app. See Flyout.)

PipsPager

Represents a control that enables navigation within linearly paginated content using a configurable collection of glyphs, each of which represents a single "page" within a limitless range.

PipsPagerSelectedIndexChangedEventArgs

Provides data for the PipsPager.SelectedIndexChanged event.

PipsPagerTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a PipsPager.

Pivot

Represents a control that provides quick navigation of views within an app.

PivotItem

Represents the container for an item in a Pivot control.

PivotItemEventArgs

Event arguments for dynamically interacting with the PivotItem before use, allowing for delay load scenarios.

ProgressBar

Represents a control that indicates the progress of an operation.

ProgressBarTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a ProgressBar control. Not intended for general use.

ProgressRing

Represents a control that indicates the progress of an operation. The typical visual appearance is a ring-shaped "spinner".

ProgressRingTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a ProgressRing control. Not intended for general use.

RadioButton

Represents a button that allows a user to select a single option from a group of options.

RadioButtons

Represents a control that shows a group of related options from which one can be selected.

RadioMenuFlyoutItem

Represents a menu item that is mutually exclusive with other radio menu items in its group.

RatingControl

Represents a control that lets a user enter a star rating.

RatingItemFontInfo

Represents information about the visual states of font elements that represent a rating.

RatingItemImageInfo

Represents information about the visual states of image elements that represent a rating.

RatingItemInfo

Represents information about the visual states of the elements that represent a rating.

RefreshContainer

Represents a container control that provides a RefreshVisualizer and pull-to-refresh functionality for scrollable content.

RefreshInteractionRatioChangedEventArgs

Provides event data.

RefreshRequestedEventArgs

Provides event data for RefreshRequested events.

RefreshStateChangedEventArgs

Provides event data for the RefreshVisualizer.RefreshStateChanged event.

RefreshVisualizer

Represents a control that provides animated state indicators for content refresh.

RelativePanel

Defines an area within which you can position and align child objects in relation to each other or the parent panel.

RevealListViewItemPresenter

Represents a specialized ListViewItemPresenter that supports custom visual state management.

Note

No longer required. Please use ListViewItemPresenter in Windows 10 April 2018 Update (version 1803) and newer.

RichEditBox

Represents a rich text editing control that supports formatted text, hyperlinks, and other rich content.

RichEditBoxSelectionChangingEventArgs

Provides event data for the RichEditBox.SelectionChanging event.

RichEditBoxTextChangingEventArgs

Provides event data for the RichEditBox.TextChanging event.

RichTextBlock

Represents a rich text display container that supports formatted text, hyperlinks, inline images, and other rich content. 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.

ScrollingAnchorRequestedEventArgs

Provides data for the ScrollView.AnchorRequested event.

ScrollingBringingIntoViewEventArgs

Provides data for the ScrollView.BringingIntoView event.

ScrollingScrollAnimationStartingEventArgs

Provides data for the ScrollView.ScrollAnimationStarting event.

ScrollingScrollCompletedEventArgs

Provides data for the ScrollView.ScrollCompleted event.

ScrollingScrollOptions

Represents options that can be set in scroll methods of the ScrollView control.

ScrollingZoomAnimationStartingEventArgs

Provides data for the ScrollView.ZoomAnimationStarting event.

ScrollingZoomCompletedEventArgs

Provides data for the ScrollView.ZoomCompleted event.

ScrollingZoomOptions

Represents options that can be set in zoom methods of the ScrollView control.

ScrollView

Represents a container that provides scroll, pan, and zoom support for its content.

ScrollViewer

Represents a scrollable area that can contain other visible elements.

ScrollViewerView

Provides a view for a ScrollViewer when its view is changing.

ScrollViewerViewChangedEventArgs

Provides event data for the ViewChanged event and similar control-specific events.

ScrollViewerViewChangingEventArgs

Provides event data for the ViewChanging event and similar control-specific events.

SectionsInViewChangedEventArgs

Provides data for the Hub.SectionsInViewChanged event.

SelectionChangedEventArgs

Provides data for the SelectionChanged event.

SelectorBar

Represents a control that consists of a small group of options from which one is selected.

SelectorBarItem

Represents one item of content in a SelectorBar control.

SelectorBarSelectionChangedEventArgs

Provides data for the SelectorBar.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.

SplitButton

Represents a button with two parts that can be invoked separately. One part behaves like a standard button and the other part invokes a flyout.

SplitButtonClickEventArgs

Provides event data for the SplitButton.Click.

SplitView

Represents a container with two views; one view for the main content and another view that is typically used for navigation commands.

SplitViewPaneClosingEventArgs

Provides event data for the SplitView.PaneClosing event.

StackLayout

Represents an attached layout that arranges child elements into a single line that can be oriented horizontally or vertically.

StackPanel

Arranges child elements into a single line that can be oriented horizontally or vertically.

StyleSelector

Enables custom item style selection logic 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.

Important

SwapChainBackgroundPanel may be altered or unavailable for releases after Windows 8.1 Instead, use SwapChainPanel.

SwapChainPanel

Provides a hosting surface, where Microsoft DirectX swap chains provide content that can be rendered into a XAML UI. A SwapChainPanel element is a key component for an app that renders Microsoft DirectX graphics and then presents those visuals within a XAML page.

SwipeControl

Represents a container that provides access to, and the ability to invoke, contextual commands through a basic touch interaction.

SwipeItem

Represents an individual command in a SwipeControl.

SwipeItemInvokedEventArgs

Provides event data for the SwipeItem.Invoked event.

SwipeItems

Represents a collection of SwipeItem objects.

SymbolIcon

Represents an icon that uses a glyph from the SymbolThemeFontFamily resource as its content.

SymbolIconSource

Represents an icon source that uses a glyph from the Segoe MDL2 Assets font as its content.

TabView

The TabView control is a way to display a set of tabs and their respective content. Tab controls are useful for displaying several pages (or documents) of content while giving a user the capability to rearrange, open, or close new tabs.

Is this the right control?

Use a TabView to help the user manage multiple app pages or documents within the same window.

Do not use a TabView to display a static set of tabs that the user cannot rearrange, open, or close. Use a NavigationView (NavigationViewPaneDisplayMode of Top) instead.

TabViewItem

Represents a single tab within a TabView.

TabViewItemTemplateSettings

Gets an object that provides calculated values that can be referenced as {TemplateBinding} markup extension sources when defining templates for a TabViewItem control.

TabViewTabCloseRequestedEventArgs

Provides data for a tab close event.

TabViewTabDragCompletedEventArgs

Provides data for the TabView.TabDragCompleted event.

TabViewTabDragStartingEventArgs

Provides data for the TabView.TabDragStarting event.

TabViewTabDroppedOutsideEventArgs

Provides data for the TabView.TabDroppedOutside event.

TeachingTip

A teaching tip is a notification flyout used to provide contextually relevant information. It supports rich content (including titles, subtitles, icons, images, and text) and can be configured for either explicit or light-dismiss.

TeachingTipClosedEventArgs

Provides data for the TeachingTip.Closed event.

TeachingTipClosingEventArgs

Provides data for the TeachingTip.Closing event.

TeachingTipTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a TeachingTip.

TextBlock

Provides a lightweight control for displaying small amounts of text.

TextBox

Represents a control that can be used to display and edit plain text (single or multi-line).

TextBoxBeforeTextChangingEventArgs

Provides event data for the TextBox.BeforeTextChanging event.

TextBoxSelectionChangingEventArgs

Provides event data for the TextBox.SelectionChanging event.

TextBoxTextChangingEventArgs

Provides event data for the TextBox.TextChanging event.

TextChangedEventArgs

Provides data for the TextChanged event.

TextCommandBarFlyout

Represents a specialized CommandBarFlyout that contains commands for editing text.

TextCompositionChangedEventArgs

Provides event data for the TextCompositionChanged event on TextBox and RichEditBox.

TextCompositionEndedEventArgs

Provides event data for the TextCompositionEnded event on TextBox and RichEditBox.

TextCompositionStartedEventArgs

Provides event data for the TextCompositionStarted event on TextBox and RichEditBox.

TextControlCopyingToClipboardEventArgs

Provides event data for the CopyingToClipboard event.

TextControlCuttingToClipboardEventArgs

Provides event data for the CuttingToClipboard event.

TextControlPasteEventArgs

Provides data for the text control Paste event.

TimePickedEventArgs

Provides data for the TimePicked event.

TimePicker

Represents a control that allows a user to pick a time value.

TimePickerFlyout

Represents a control that allows a user to pick a time value.

TimePickerFlyoutPresenter

Represents the visual container for the TimePickerFlyout.

TimePickerSelectedValueChangedEventArgs

Provides event data for the TimePicker.SelectedTimeChanged event.

TimePickerValueChangedEventArgs

Provides event data for the TimePicker.TimeChanged event.

ToggleMenuFlyoutItem

Represents an item in a MenuFlyout that a user can change between two states, checked or unchecked.

ToggleSplitButton

Represents a button with two parts that can be invoked separately. One part behaves like a toggle button that can be on or off, while the other part invokes a flyout that contains additional options for the user to choose from.

ToggleSplitButtonIsCheckedChangedEventArgs

Provides event data for the ToggleSplitButton.IsCheckedChanged event.

ToggleSwitch

Represents a switch that can be toggled between two states.

ToolTip

Represents a pop-up window for displaying information about an element in the UI.

ToolTipService

Represents a service that provides static methods to display a ToolTip.

TreeView

Represents a hierarchical list with expanding and collapsing nodes that contain nested items.

TreeViewCollapsedEventArgs

Provides event data for the TreeView.Collapsed event.

TreeViewDragItemsCompletedEventArgs

Provides event data for the TreeView.DragItemsCompleted event.

TreeViewDragItemsStartingEventArgs

Provides event data for the TreeView.DragItemsStarting event.

TreeViewExpandingEventArgs

Provides event data for the TreeView.Expanding event.

TreeViewItem

Represents the container for an item in a TreeView control.

TreeViewItemInvokedEventArgs

Provides event data for the TreeView.ItemInvoked event.

TreeViewItemTemplateSettings

Provides calculated values that can be referenced as TemplatedParent sources when defining templates for a TreeViewItem control. Not intended for general use.

TreeViewList

Represents a flattened list of tree view items so that operations such as keyboard navigation and drag-and-drop can be inherited from ListView.

TreeViewNode

Represents a node in a TreeView control.

TreeViewSelectionChangedEventArgs

Provides data for the TreeView.SelectionChanged event.

TwoPaneView

Represents a container with two views that size and position content in the available space, either side-by-side or top-bottom.

UIElementCollection

Represents an ordered collection of UIElement objects.

UniformGridLayout

Positions elements sequentially from left to right or top to bottom in a wrapping layout.

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.

VirtualizingLayout

Represents the base class for an object that sizes and arranges child elements for a host and supports virtualization.

VirtualizingLayoutContext

Represents the base class for layout context types that support virtualization.

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. Can only be used to display items in an ItemsControl.

WebView2

Represents an object that enables the hosting of web content.

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. Can only be used to display items in an ItemsControl. See Remarks.

XamlControlsResources

Default styles for the controls in the WinUI library.

Interfaces

IAnimatedVisual

An animated Composition.Visual that can be used by other objects, such as an AnimatedVisualPlayer or AnimatedIcon.

IAnimatedVisual2

An animated Composition.Visual that can be used by other objects, such as an AnimatedVisualPlayer or AnimatedIcon. Extends IAnimatedVisual with methods to create and destroy animations.

IAnimatedVisualSource

An animated Visual that can be used by other objects, such as an AnimatedVisualPlayer.

IAnimatedVisualSource2

An animated Visual that can be used by other objects, such as an AnimatedIcon. Extends IAnimatedVisualSource

IAnimatedVisualSource3

An animated Composition.Visual that can be used by other objects, such as an AnimatedVisualPlayer or AnimatedIcon. Extends IAnimatedVisualSource2

ICommandBarElement

Defines the compact view for command bar elements.

IDynamicAnimatedVisualSource

When implemented by an IAnimatedVisualSource, indicates to the player that the current animated visual should be discarded.

IInsertionPanel

Provides methods to let an item be inserted between other items in a drag-and-drop operation.

IItemContainerMapping

Provides methods that let an ItemsControl map data items to UI containers.

IKeyIndexMapping

Provides methods that support mapping between an item's unique identifier and index.

INavigate

Defines the navigation action for navigation hosts and navigation initiators.

IScrollAnchorProvider

Specifies a contract for a scrolling control that supports scroll anchoring.

ISemanticZoomInformation

Communicates the info needed for a view to serve as one of the two possible views (ZoomedOutView or ZoomedInView) of a SemanticZoom.

Enums

AnnotatedScrollBarScrollingEventKind

Defines constants that specify how a scrolling action was initiated in an AnnotatedScrollBar.

AppBarClosedDisplayMode

Defines constants that specify whether icon buttons are displayed when an app bar is not completely open.

AutoSuggestionBoxTextChangeReason

Values used to indicate the reason for the text changing in the AutoSuggestBox.

BackgroundSizing

Defines constants that specify how far an element's background extends in relation to the element's border.

CalendarViewDisplayMode

Defines constants that specify which view of the calendar is shown.

CalendarViewSelectionMode

Defines constants that specify what kind of date selections are allowed in the calendar.

CandidateWindowAlignment

Defines constants that specify how the Input Method Editor (IME) window for text predictions is aligned with a text edit control.

CharacterCasing

Defines constants that specify how a control modifies the case of characters as they are typed.

ClickMode

Specifies when the Click event should be raised for a control.

ColorPickerHsvChannel

Defines constants for specifying which Hue-Saturation-Value (HSV) and Alpha channel values a slider sets in a ColorPicker control.

ColorSpectrumComponents

Defines constants that specify how the Hue-Saturation-Value (HSV) color components are mapped onto the ColorSpectrum.

ColorSpectrumShape

Defines constants that specify how the ColorSpectrum control is shown.

ComboBoxSelectionChangedTrigger

Defines constants that specify what action causes a SelectionChanged event to occur.

CommandBarDefaultLabelPosition

Defines constants that specify the placement and visibility of AppBarButton labels in a CommandBar.

CommandBarDynamicOverflowAction

Defines constants that specify whether items were added to or removed from the CommandBar overflow menu.

CommandBarLabelPosition

Defines constants that specify the placement and visibility of an app bar button's label.

CommandBarOverflowButtonVisibility

Defines constants that specify when a command bar's overflow button is shown.

ContentDialogButton

Defines constants that specify the default button on a content dialog.

ContentDialogPlacement

Defines constants that specify where in the XAML visual tree a ContentDialog is rooted.

ContentDialogResult

Specifies identifiers to indicate the return value of a ContentDialog

DisabledFormattingAccelerators

Defines constants that specify which keyboard shortcuts for formatting are disabled in a RichEditBox.

ElementRealizationOptions

Defines constants that specify whether to suppress automatic recycling of the retrieved element or force creation of a new element.

ExpandDirection

Defines constants that specify in which direction a control should expand.

IncrementalLoadingTrigger

Defines constants that specify list view incremental loading behavior (IncrementalLoadingTrigger property).

IndexBasedLayoutOrientation

Defines constants that specify whether there is a correlation between the items indices and how they are laid out.

InfoBarCloseReason

Defines constants that indicate the cause of the InfoBar closure.

InfoBarSeverity

Defines constants that indicate the criticality of the InfoBar that is shown.

ItemCollectionTransitionOperation

Defines constants that specify the type of transition operation to animate.

ItemCollectionTransitionTriggers

Defines constants that specify what caused the collection transition animation to occur.

ItemsUpdatingScrollMode

Defines constants that specify the scrolling behavior of items while updating.

ItemsViewSelectionMode

Defines constants that specify the selection mode of an ItemsView.

LightDismissOverlayMode

Defines constants that specify whether the area outside of a light-dismiss UI is darkened.

LinedFlowLayoutItemsJustification

Defines constants that specify how items are aligned on the horizontal axis in a LinedFlowLayout.

LinedFlowLayoutItemsStretch

Defines constants that specify how items are sized to fill the available space in a LinedFlowLayout.

ListPickerFlyoutSelectionMode

Defines constants that specify the selection mode of a ListPickerFlyout.

ListViewReorderMode

Defines constants that specify the reorder mode of a ListView or GridView.

ListViewSelectionMode

Defines constants that specify the selection mode of a ListView or GridView.

NavigationViewBackButtonVisible

Defines constants that specify whether the back button is visible in NavigationView.

NavigationViewDisplayMode

Defines constants that specify how the pane is shown in a NavigationView.

NavigationViewOverflowLabelMode

Defines constants that specify the label for the overflow button in a NavigationView.

NavigationViewPaneDisplayMode

Defines constants that specify how and where the NavigationView pane is shown.

NavigationViewSelectionFollowsFocus

Defines constants that specify whether item selection changes when keyboard focus changes in a NavigationView.

NavigationViewShoulderNavigationEnabled

Defines constants that specify when game controller bumpers can be used to navigate the top-level navigation items in a NavigationView.

NumberBoxSpinButtonPlacementMode

Defines values that specify how the spin buttons used to increment or decrement the Value of a NumberBox are displayed.

NumberBoxValidationMode

Defines values that specify the input validation behavior of a NumberBox when invalid input is entered.

Orientation

Defines constants that specify the different orientations that a control or layout can have.

PanelScrollingDirection

Defines constants that specify the direction that a panel is scrolling.

ParallaxSourceOffsetKind

Defines constants that specify how the source offset values of a ParallaxView are interpreted.

PasswordRevealMode

Defines constants that specify the password reveal behavior of a PasswordBox.

PipsPagerButtonVisibility

Defines constants that specify how the navigation buttons of the PipsPager are displayed.

PivotHeaderFocusVisualPlacement

Defines constants that specify the style of focus visual used for pivot header items.

PivotSlideInAnimationGroup

Defines constants that specify the different slide-in animation groups that Pivot elements can belong to.

PlayerAnimationOptimization

Defines constants that specify how an AnimatedVisualPlayer caches animations when the player is idle.

RefreshPullDirection

Defines constants that specify the direction to pull a RefreshContainer to initiate a refresh.

RefreshVisualizerOrientation

Defines constants that specify the orientation of a RefreshVisualizer.

RefreshVisualizerState

Defines constants that specify the state of a RefreshVisualizer

RequiresPointer

Defines constants that specify when an element requires a mouse-like pointer behavior from a game controller.

RichEditClipboardFormat

Defines constants that specify the format of text copied from a RichEditBox.

ScrollBarVisibility

Defines constants that specify the visibility of a scrollbar within a ScrollViewer control.

ScrollingAnimationMode

Defines constants that specify whether the ScrollView control plays animations for scrolling and zooming actions.

ScrollingChainMode

Defines constants that specify how scroll- and zoom-chaining is handled by the ScrollView control.

ScrollingContentOrientation

Defines constants that specify the orientation of content scrolling in a ScrollView.

ScrollingInputKinds

Defines constants that specify kinds of input that are ignored by a ScrollView.

ScrollingInteractionState

Defines constants that specify the interaction state of a ScrollView.

ScrollingRailMode

Defines constants that specify the state of the scroll rail for a ScrollView.

ScrollingScrollBarVisibility
ScrollingScrollMode

Defines constants that specify scrolling behavior for the ScrollView control.

ScrollingSnapPointsMode

Defines constants that specify how the ScrollView handles snap points.

ScrollingZoomMode

Defines constants that specify whether the ScrollView can zoom in and out by means of user input.

ScrollIntoViewAlignment

Defines constants that describe how an item that is programmatically scrolled into view aligns with the visible area.

ScrollMode

Defines constants that specify scrolling behavior for ScrollViewer and other parts involved in scrolling scenarios.

SelectionMode

Defines constants that specify the selection behavior for a ListBox.

SnapPointsType

Defines constants that specify how panning snap points are processed for gesture/manipulation input.

SplitViewDisplayMode

Defines constants that specify how the pane is shown in a SplitView.

SplitViewPanePlacement

Defines constants that specify whether the pane is to the left or right of the content in a SplitView.

StretchDirection

Defines constants that specify the direction that content is scaled.

SwipeBehaviorOnInvoked

Defines constants that specify how a SwipeControl behaves after a command is invoked.

SwipeMode

Defines constants that specify the effect of a swipe interaction.

Symbol

Defines constants that specify a glyph from the Segoe MDL2 Assets font to use as the content of a SymbolIcon.

TabViewCloseButtonOverlayMode

Defines constants that describe the behavior of the close button contained within each TabViewItem.

TabViewWidthMode

Defines constants that specify the width of the tabs.

TeachingTipCloseReason

Defines constants that indicate the cause of the TeachingTip closure.

TeachingTipHeroContentPlacementMode

Defines constants that indicate the preferred location of the HeroContent within a teaching tip.

TeachingTipPlacementMode

Defines constants that indicate the preferred location of the TeachingTip teaching tip.

TeachingTipTailVisibility

Defines constants that specify whether a teaching tip's Tail is visible or collapsed.

TreeViewSelectionMode

Defines constants that specify the selection behavior for a TreeView instance.

TwoPaneViewMode

Defines constants that specify how panes are shown in a TwoPaneView.

TwoPaneViewPriority

Defines constants that specify which pane has priority in a TwoPaneView.

TwoPaneViewTallModeConfiguration

Defines constants that specify how panes are shown in a TwoPaneView in tall mode.

TwoPaneViewWideModeConfiguration

Defines constants that specify how panes are shown in a TwoPaneView in wide mode.

UniformGridLayoutItemsJustification

Defines constants that specify how items are aligned on the non-scrolling or non-virtualizing axis.

UniformGridLayoutItemsStretch

Defines constants that specify how items are sized to fill the available space in a UniformGridLayout.

VirtualizationMode

Defines constants that specify how VirtualizingStackPanel manages item containers for its child items.

ZoomMode

Defines constants that specify the current mode for zoom behavior in the ScrollViewer content.

Delegates

CalendarViewDayItemChangingEventHandler

Represents the method that will handle the CalendarViewDayItemChanging event.

CleanUpVirtualizedItemEventHandler

Represents the method that handles the CleanUpVirtualizedItemEvent attached event.

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.

HubSectionHeaderClickEventHandler

Represents the method that will handle a Hub.SectionHeaderClick event.

ItemClickEventHandler

Represents the method that will handle an ItemClick event.

ListViewItemToKeyHandler

Represents the method that will handle callback for the GetRelativeScrollPosition method.

ListViewKeyToItemHandler

Represents the asynchronous method that will handle callback for the SetRelativeScrollPositionAsync method.

SectionsInViewChangedEventHandler

Represents the method that will handle a SectionsInViewChanged 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.

TextControlPasteEventHandler

Represents the method that will handle a Paste event.

Examples

The WinUI 3 Gallery app includes interactive examples of most WinUI 3 controls, features, and functionality. Get the app from the Microsoft Store or get the source code on GitHub.