Provide a cross platform API for customizing the TitleBar of desktop apps

[PureWeen]

Description

Currently the TitleBar on WinUI isn't easily changeable from the xplat code. Users can modify the WinUI AppTitleBar through resources #5811 but ideally you could configure it through xplat code.

On Catalyst we currently have no way to do this other than users just adding the behavior themselves through the handler and hacking the layouts to work.

Related Issues

• Negative margin required to place content in TitleBar area when TitleBar is Hidden #5710
• Need way to customize window titlebar + MenuBarItems fonts & styles #9837
• [WinUI][MacOS?] Disable/Enable/Show/Hide Close/Minimize/Maximize buttons easily #10297
• Can menu bar set in Caption\Title Bar? #7160
• Title bar still not behaving correctly... #7123
• On Windows (WinUI) Minimize, Normal, Maximize buttons behave strangely #7751

(Public) API Changes

TitleBar Control

This control is mostly based on the control in the WinAppSDK 1.6 Preview:

Properties

API	Type	Description
Icon	ImageSource	The ImageSource for the TitleBar icon
LeadingContent	IView	Leading content, appears before the Content, allows full hit test
Content	IView	Centered content, allows full hit test
TrailingContent	IView	Trailing content, appears after the Content, allows full hit test
Title	string	The title text of the window
Subtitle	string	The subtitle text, follows the title text
BackgroundColor	Color	The background color
ForegroundColor	Color	The foreground color of the Title and Subtitle text
InactiveBackgroundColor	Color	The background color of the TitleBar when the window is not in focus
InactiveForegroundColor	Color	The foreground color of the Title and Subtitle text when the window is not focused
IsVisible	bool	Setting this to False will hide the TitleBar

Window

Methods

API	Description
SetTitleBar(TitleBar)	Sets the TitleBar

Usage Scenarios

XAML

<ContentPage>
     <TitleBar
         x:Name="MyTitleBar"
         Title="{Binding Title}" />
         <TitleBar.Content>
             <Entry
                 Text="{Binding SearchInput}"/>
         </TitleBar.Content>
...

Backing .cs

protected override void OnAppearing()
{
    base.OnAppearing();
    Window.SetTitleBar(MyTitleBar);
}

Backward Compatibility

N/A

Difficulty

High

VS bug #1864265

[ghost]

We've moved this issue to the Backlog milestone. This means that it is not going to be worked on for the coming release. We will reassess the backlog following the current release and consider this item at that time. To learn more about our issue management process and to have better expectation regarding different types of issues you can read our Triage Process.

[lfmouradasilva]

Any updates on this issue?

[bdovaz]

Any updates on this issue?

@Foda Here I see in the final sentence of the comment you mention new APIs:

#18773 (comment)

But with In the next release how far is it? Minor release? Major release (.NET 9)?

[bdovaz]

I have been trying to do a complex customization and have found myself at a dead end:

#19192

[mhrastegari]

Any updates on this? :(