| title | author | description | keywords | dev_langs | category | subcategory | experimental | discussion-id | issue-id | icon | |
|---|---|---|---|---|---|---|---|---|---|---|---|
TitleBar |
niels9001 |
A control that provides a modern TitleBar |
TitleBar, Control, Layout |
|
Controls |
Layout |
true |
0 |
0 |
assets/icon.png |
Note
WindowsAppSDK 1.6-experimental introduced a TitleBar control based on the work here in the Toolkit. If you're using WindowsAppSDK and plan to use 1.6 when it becomes available, find more information about the new control here: https://learn.microsoft.com/windows/apps/windows-app-sdk/experimental-channel#new-titlebar-control
The TitleBar provides an easy way to display a modern titlebar experience. The control handles all the required APIs to extend content into the titlebar area and set custom drag regions. The control is set up in a way that it handles the correct design guidelines while being flexible in what content to show.
[!Sample TitleBarConfigSample]
[!Sample TitleBarFullSample]
If AutoConfigureCustomTitleBar is enabled, the TitleBar will make the required code-behind changes to make your content extend into the titlebar area and setting the correct caption background brushes. However, launching the app might briefly show the standard titlebar. To overcome this, make sure you set the following code in the OnLaunched method (in App.xaml.cs) or wherever you create your window:
currentWindow.AppWindow.TitleBar.ExtendsContentIntoTitleBar = true;
currentWindow.AppWindow.TitleBar.ButtonBackgroundColor = Microsoft.UI.Colors.Transparent;
`