Host your own UI inside the Windows 11 taskbar Windows 11 작업 표시줄 안에 직접 만든 UI를 띄워 보세요

Quick start시작하기

Create a window, pass it and its root element to TaskbarContentHost, then attach it once the taskbar layout is ready. WinUI 3 and WPF share the same API; only the Window and FrameworkElement types come from different namespaces.

창을 만든 다음 창과 루트 요소를 TaskbarContentHost에 넘기고, 작업 표시줄 레이아웃이 준비되면 창을 붙입니다. WinUI 3와 WPF는 같은 API를 사용하며, Window와 FrameworkElement 타입의 네임스페이스만 다릅니다.

using Deskband11Lib.Core;
using Deskband11Lib.WinUI;

var window = new MainWindow();
var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 360,
    PreferredHeight = 48
});

await host.AttachWhenLayoutReadyAsync();
window.Activate();

using Deskband11Lib.Core;
using Deskband11Lib.Wpf;

var window = new MainWindow();
var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 360,
    PreferredHeight = 48
});

await host.AttachWhenLayoutReadyAsync();
window.Show();

Recreate the window when the taskbar drops it창이 사라지면 다시 만들기

An Explorer restart, a disconnected monitor, or a DPI change can destroy the hosted window or leave it misaligned. Handle TaskbarWindowRecreationRequired, build a new window, and attach a new host.

Explorer가 재시작되거나, 모니터 연결이 끊기거나, DPI가 바뀌면 호스팅된 창이 사라지거나 위치가 어긋날 수 있습니다. TaskbarWindowRecreationRequired 이벤트에서 창을 새로 만들고 새 호스트를 붙이면 됩니다.

host.TaskbarWindowRecreationRequired += async (_, _) => await RecreateMainWindowAsync();

The snippets show the shape of the API. For window lifetime, startup order, and framework-specific hosting, start from the WinUI 3 sample or the WPF sample, which also sets up a transparent borderless host window.

위 코드는 API의 형태만 보여 줍니다. 창 수명 주기, 시작 순서, 프레임워크별 호스팅 처리는 WinUI 3 샘플이나 WPF 샘플에서 시작하시는 것을 권장합니다. WPF 샘플에는 테두리 없는 투명 호스트 창 설정도 들어 있습니다.

Placement배치

UI Automation locates the Start button, the app buttons, the Widgets button, and the notification area. Content goes into one of the free gaps between them, chosen by the Placement option and the taskbar alignment, which is read from the TaskbarAl registry value.

UI Automation으로 시작 버튼, 앱 버튼, 위젯 버튼, 알림 영역의 위치를 찾습니다. 콘텐츠는 그 사이에 남는 공간 중 한 곳에 배치되며, 어느 공간을 쓸지는 Placement 옵션과 작업 표시줄 정렬에 따라 정해집니다. 작업 표시줄 정렬은 레지스트리의 TaskbarAl 값에서 읽습니다.

Several instances in one area한 영역을 나눠 쓰는 여러 인스턴스

Instances that target the same area on the same monitor coordinate through a shared-memory slot registry and split the space without overlapping. Fixed instances, with a finite PreferredWidth, are served first in ManualSlotPriority order, then in arrival order. Stretch instances, with PreferredWidth = double.MaxValue, share whatever is left.

같은 모니터의 같은 영역을 대상으로 하는 인스턴스들은 공유 메모리 슬롯 레지스트리로 서로 조정하여 겹치지 않게 공간을 나눕니다. PreferredWidth가 유한한 Fixed 인스턴스가 ManualSlotPriority 순서, 그다음 도착 순서에 따라 먼저 너비를 받고, PreferredWidth = double.MaxValue인 Stretch 인스턴스들은 남은 공간을 똑같이 나눕니다.

Options옵션

All options live in Deskband11Lib.Core.TaskbarContentHostOptions and work the same in every package.

모든 옵션은 Deskband11Lib.Core.TaskbarContentHostOptions에 정의되어 있으며, 어느 패키지에서든 똑같이 동작합니다.

Packages and requirements패키지와 요구 사항

• Windows 11.
• .NET 10. The packages target net10.0-windows10.0.26100.0.
• WinUI 3 apps need the Windows App SDK.

• Windows 11이 필요합니다.
• .NET 10이 필요합니다. 패키지의 대상 프레임워크는 net10.0-windows10.0.26100.0입니다.
• WinUI 3 앱에는 Windows App SDK가 필요합니다.