microsoft / microsoft/microsoft-ui-xaml

Proposal: Add dark mode for window caption button tooltip

Open
#11,802 10 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area-TitleBar area-Windowing feature proposal team-Core
Dominant language
C++
Stars
8.4k
Forks
942
Avg merge
2d 7h
Merged PRs (30d)
105

Description

### Title

Add dark mode support for window caption button tooltip

### Summary

When `ExtendsContentIntoTitleBar`, the window caption buttons are already self-drawn (as opposed to the standard win32 standard window caption buttons). It would be more consistent to support dark theme for the caption button's tooltip when the window content is also in dark mode.

### Rationale

Some software already does this (even Microsoft's own Visual Studio does this). This makes the window looks consistent and more polished.

|WinUI3 currently|Visual Studio Code|
|---|---|
|Image|Image|

**But! Please fix #10438 first**

### Scope

| Capability | Priority |
| :---------- | :------- |
| The caption button tooltip automatically changes theme according to `Window.Content` | Must |
| Provide a API to set the caption button tooltip's theme | Could |
| Allow customizing the caption button tooltip with xaml (exactly like what Window Terminal already does) | Could |
| Fix existing incorrect tooltip as in #10438 | Must |

### Important Notes

_No response_

### Open Questions

_No response_

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing issue #10438 and the existing caption button tooltip behavior in the WinUI repository. Compare the required automatic theme change with the optional API and XAML customization proposals, then verify that the tooltip follows Window.Content's theme and that the incorrect behavior described in #10438 is fixed.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
design, desktop
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.