앱 창 관리

Windows 앱 SDK HWND의 상위 수준 추상화를 나타내는 Microsoft.UI.Windowing.AppWindow 클래스를 제공합니다. 앱에서는 AppWindow와 최상위 HWND 간에 1:1 매핑됩니다. AppWindow 및 관련 클래스는 HWND에 직접 액세스할 필요 없이 앱 최상위 창의 여러 측면을 관리할 수 있는 API를 제공합니다.

비고

이 문서에서는 앱에서 API를 사용하는 AppWindow 방법을 보여 줍니다. 필수 조건으로 WinUI 3 및 Windows 앱 SDK 대한 Windowing 개요의 정보를 읽고 이해하는 것이 좋습니다. 이 정보는 WinUI 또는 다른 UI 프레임워크를 사용하는지 여부에 관계없이 적용됩니다.

• 중요 API: AppWindow 클래스, OverlappedPresenter 클래스

WinUI 3 갤러리 앱을 열고 작동 중 확인 AppWindow

WinUI 3 갤러리 앱에는 WinUI 컨트롤 및 기능의 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub 소스 코드를 찾습니다.

Windows 앱 SDK 지원하는 UI 프레임워크(WinUI, WPF, WinForms 또는 Win32)에서 AppWindow API를 사용할 수 있습니다. AppWindow API는 프레임워크별 창 API와 함께 작동합니다.

• Xaml Window
• WPF Window
• Windows Forms 양식
• Win32 windowing API, MFC Windows

일반적으로 AppWindow API를 사용하여 다음을 수행합니다.

• 앱 창의 크기와 위치를 관리합니다.

• 창 제목, 아이콘 및 제목 표시줄 색을 관리합니다. 또는 AppWindowTitleBar API를 사용하여 완전히 사용자 지정 제목 표시줄을 만듭니다.

  자세한 정보 및 예제는 제목 표시줄 사용자 지정 을 참조하세요.

• AppWindowPresenter 파생 API를 사용하여 창의 모양과 동작을 관리합니다.

변경 사항에 대응 AppWindow

변경 사항에 응답하려면 단일 AppWindow 이벤트를 처리하고 이벤트 인수(AppWindowChangedEventArgs)를 확인하여 어떤 종류의 변경이 발생했는지 판단합니다. 관심 있는 변경이 발생한 경우 이에 응답할 수 있습니다. 잠재적인 변경 사항에는 위치, 크기, 발표자, 표시 유형 및 z 순서가 포함됩니다.

여기 AppWindow.Changed 이벤트 처리기의 예가 있습니다.

private void AppWindow_Changed(AppWindow sender, AppWindowChangedEventArgs args)
{
    // ConfigText and SizeText are TextBox controls defined in XAML for the page.
    if (args.DidPresenterChange == true)
    {
        ConfigText.Text = sender.Presenter.Kind.ToString();
    }

    if (args.DidSizeChange == true)
    {
        SizeText.Text = sender.Size.Width.ToString() + ", " + sender.Size.Height.ToString();
    }
}

Window 크기 및 배치

클래스 AppWindow 에는 창의 크기와 배치를 관리하는 데 사용할 수 있는 몇 가지 속성과 메서드가 있습니다.

카테고리	속성
읽기 전용 속성	위치, 크기, ClientSize
Events	변경됨 (DidPositionChange, DidSizeChange)
크기 및 위치 메서드	Move, Resize, ResizeClient, MoveAndResize
Z 순서 메소드	MoveInZOrderAtBottom, MoveInZOrderAtTop, MoveInZOrderBelow

크기 조정을 호출하여 새 창 크기를 지정합니다.

이 예제에서는 코드가 MainWindow.xaml.cs있으므로 .Window 속성을 사용하여AppWindow 인스턴스를 AppWindow 가져올 수 있습니다.

public MainWindow()
{
    InitializeComponent();
    AppWindow.Resize(new Windows.Graphics.SizeInt32(1200, 800));
}

Move 메서드를 호출하여 창의 위치를 변경합니다.

다음은 사용자가 단추를 클릭할 때 화면을 가운데로 이동하도록 창을 이동하는 예제입니다.

이는 Page 클래스의 코드 파일에서 발생하기 때문에 자동으로 Window 개체나 AppWindow 개체에 액세스할 수 없습니다. 당신은 AppWindow를 얻는 방법에는 몇 가지 옵션이 있습니다.

• Window나 현재 창 추적 또는 트랙 인스턴스 Window에 설명된 대로 참조를 유지하면, Window를 가져온 후 AppWindow 속성에서 Window를 가져올 수 있습니다.
• 또는 정적 AppWindow을 호출할 수 있습니다. GetFromWindowId 메서드는 여기에 표시된 대로 인스턴스를 AppWindow 가져옵니다. ( 시각적 요소를 호스팅하는 창 확인 참조)

private void MoveWindowButton_Click(object sender, RoutedEventArgs e)
{
    AppWindow appWindow = AppWindow.GetFromWindowId(XamlRoot.ContentIslandEnvironment.AppWindowId);
    RectInt32? area = DisplayArea.GetFromWindowId(appWindow.Id, DisplayAreaFallback.Nearest)?.WorkArea;
    if (area == null) return;
    appWindow.Move(new PointInt32((area.Value.Width - appWindow.Size.Width) / 2, (area.Value.Height - appWindow.Size.Height) / 2));
}

창 크기를 논리 픽셀 단위로 설정(실험적)

중요합니다

이 섹션의 Window 크기 조정 속성 API는 Windows 앱 SDK 2.3 Experimental A에서 도입된 실험적 API입니다. API는 실험적인 것으로 표시되며 향후 릴리스에서 변경되거나 제거될 수 있습니다. 프로덕션 앱에서는 사용하지 마세요. 다운로드 링크는 최신 Windows 앱 SDK 다운로드를 참조하세요.

AppWindow.Resize 및 AppWindow.ResizeClient는 물리적 픽셀 크기를 사용합니다. 서로 다른 배율 인수를 가진 디스플레이에서 동일한 크기를 얻으려면 값을 직접 변환해야 합니다. 실험적 릴리스에서는 Microsoft.UI.Xaml.Window 클래스에는 창의 클라이언트 영역 크기를 논리 픽셀(장치 독립적 픽셀(DIP)이라고도 함) 단위로 가져오고 설정하는 속성이 있습니다. 창은 현재 디스플레이 배율에 맞게 값을 변환하므로, 너비가 Width 640인 클라이언트 영역은 100% 배율에서는 너비가 640 물리적 픽셀이고 150% 배율에서는 너비가 960 물리적 픽셀입니다. AppWindow.Window 속성을 거치지 않고 XAML 또는 코드에서 이러한 속성을 설정할 수 있습니다.

재산	Description
너비, 높이	창이 복원된 상태인 경우 클라이언트 영역의 크기입니다.
MinWidth, MinHeight	사용자가 창의 크기를 조정할 수 있는 가장 작은 클라이언트 영역입니다. 기본값은 0입니다.
MaxWidth, MaxHeight	사용자가 창의 크기를 조정할 수 있는 가장 큰 클라이언트 영역입니다. 기본값은 양수 무한대입니다. 즉, 최대값은 없습니다.

WinUI 3 갤러리 앱을 열고 Window 크기 조정이 실제로 작동하는 모습을 확인하세요

다음은 XAML 파일에서 창의 초기 크기 및 크기 제한을 설정하는 예제입니다.

<Window
    x:Class="MyApp.SettingsWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Width="640"
    Height="480"
    MinWidth="320"
    MinHeight="240"
    MaxWidth="960"
    MaxHeight="720">
    <TextBlock Margin="24" Text="Resize this window." />
</Window>

다음은 코드에서 만드는 창에 대해 C#에서 동일한 값을 설정하는 예제입니다.

Window window = new Window
{
    Width = 640,
    Height = 480,
    MinWidth = 320,
    MinHeight = 240,
    MaxWidth = 960,
    MaxHeight = 720,
    Content = new TextBlock { Margin = new Thickness(24), Text = "Resize this window." }
};

// A size that you set before the first call to Activate is applied when the window is shown.
window.Activate();

이 표에서는 Window 속성이 AppWindow 크기 조정 API와 어떻게 관련되는지 보여 줍니다. 예를 들어 AppWindow.Resize(new SizeInt32(1200, 800)) 테두리 및 제목 표시줄을 포함하여 전체 창을 1200 x 800 크기의 물리적 픽셀로 만듭니다. Height를 1200으로, Width를 800으로 설정하면 클라이언트 영역의 크기는 1200 x 800 논리 픽셀이며, 150% 배율의 디스플레이에서는 1800 x 1200 물리 픽셀이 됩니다.

API	크기를 결정하는 요소	Units
Window.너비, Window.높이 (실험 기능)	복원된 창의 클라이언트 영역입니다. 값을 가져오고 설정할 수 있습니다.	논리 픽셀
Window.경계	현재 클라이언트 영역입니다. 읽기 전용입니다.	논리 픽셀
AppWindow.크기 조정	테두리 및 제목 표시줄을 포함한 전체 창입니다.	물리적 픽셀
AppWindow.ResizeClient	클라이언트 영역	물리적 픽셀
AppWindow.Size, AppWindow.ClientSize	현재 창 및 클라이언트 영역입니다. 읽기 전용입니다.	물리적 픽셀

Window 크기 조정 속성을 사용할 때는 다음 동작을 염두에 두어야 합니다.

• 복원된 크기 창이 최대화되거나 최소화되면 Width 및 Height은 창이 복원될 때 반환되는 클라이언트 크기를 반환합니다. 해당 상태로 설정하면 복원된 크기가 변경되고 창이 최대화되거나 최소화된 상태로 유지됩니다. 창에서 FullScreenPresenter 또는 CompactOverlayPresenter를 사용하는 경우 창이 OverlappedPresenter로 다시 전환될 때 설정한 크기가 적용됩니다.
• 크기 제한.MinWidth, MinHeight, MaxHeight, 및 는 창이 기본 프레젠터인 MaxWidth를 사용하는 동안 적용됩니다. 창은 발표자의 PreferredMinimumWidth, PreferredMinimumHeight, PreferredMaximumWidth 및 PreferredMaximumHeight 속성을 자동으로 설정하고, 창이 다른 배율의 디스플레이로 이동할 때 이를 업데이트합니다. Window 속성으로 제한하는 차원에 대해 해당 프레젠터 속성을 직접 설정하지 마세요. 발표자 속성에 대한 자세한 내용은 OverlappedPresenter 수정을 참조하세요.
• 최대화 상태입니다. 발표자의 PreferredMaximumWidth 및 MaxWidth 속성과 마찬가지로, PreferredMaximumHeight 및 MaxHeight도 창이 최대화된 경우에도 창의 크기를 제한합니다. 예를 들어 이전 예제에서 창을 최대화하는 경우 클라이언트 영역은 더 큰 디스플레이에서도 960 x 720 논리 픽셀보다 크지 않습니다.
• 유효한 값 Height 및 Width을 최소값과 최대값 사이의 값으로 설정합니다. Width, Height, MinWidth 및 MinHeight는 유한해야 하며 0 이상이어야 합니다. MaxWidth 및 MaxHeight은(는) 0 이상이거나 최대값이 없음을 의미하는 양의 무한대여야 합니다. 다른 값은 setter가 예외를 발생시키며, 이는 C#에서는 ArgumentException입니다.

AppWindowPresenter 클래스 및 하위 클래스

각각 AppWindow 에는 AppWindowPresenter (발표자)가 적용됩니다. 시스템에서 발표자가 생성되어 AppWindow에 생성 시 적용됩니다. AppWindowPresenter의 각 하위 클래스는 창의 용도에 적합한 미리 정의된 구성을 제공합니다. 이러한 AppWindowPresenter 파생 발표자가 제공되며 지원되는 모든 OS 버전에서 사용할 수 있습니다.

• CompactOverlayPresenter

  항상 위에 고정된 창을 16:9 화면 비율의 고정된 크기로 설정하여 화면 속 화면과 같은 경험을 제공합니다. 기본적으로 InitialSize 는 CompactOverlaySize.Small이지만 변경할 MediumLarge수 있습니다. 를 호출 AppWindow할 수도 있습니다. 크기를 조정 하여 16:9 가로 세로 비율을 재정의하고 창을 원하는 크기로 만듭니다.

• FullScreenPresenter

  비디오를 시청하는 데 적합한 전체 화면 환경을 제공하도록 창을 구성합니다. 창에 테두리나 제목 표시줄이 없으며 시스템 작업 표시줄을 숨깁니다.

• OverlappedPresenter

  기본적으로 크기 조정 핸들이 있는 테두리와 최소화/최대화/복원 단추가 있는 제목 표시줄을 제공하는 표준 창 구성입니다.

비고

Win32 애플리케이션 모델의 새로운 개념인 발표자는 창 상태와 스타일의 조합과 유사하지만 동일하지는 않습니다. 일부 발표자에는 클래식 창 상태 및 스타일 속성(예: 자동 숨기기 제목 표시줄)에서 검사할 수 없는 동작이 정의되어 있습니다.

기본 발표자

기본 발표자는 AppWindow이 생성될 때 적용되는 기본 속성 설정이 있는 OverlappedPresenter의 인스턴스입니다. 기본 발표자로 돌아가기 위해 다른 발표자를 적용한 후 창에 대한 참조를 유지할 필요가 없습니다. 시스템이 생성된 AppWindow의 수명 동안 이 프레젠터의 동일한 인스턴스를 유지하기 때문에, AppWindow.SetPresenter 메서드를 AppWindowPresenterKind.Default를 매개 변수로 사용하여 호출하면 다시 적용할 수 있습니다.

중요합니다

호출 SetPresenter(AppWindowPresenterKind.Default)은 AppWindow로 생성한 기본 프레젠터 인스턴스를 항상 다시 적용합니다. 다른 발표자를 만들고 적용하고 나중에 다시 적용하려면 발표자에 대한 참조를 유지해야 합니다.

기본 발표자 인스턴스에 대한 참조를 가져와서 수정할 수도 있습니다. 새 발표자를 적용한 경우 먼저 다음과 같이 기본 발표자가 적용되었는지 확인합니다.

appWindow.SetPresenter(AppWindowPresenterKind.Default);
OverlappedPresenter defaultPresenter = (OverlappedPresenter)appWindow.Presenter;
defaultPresenter.IsMaximizable = false;
defaultPresenter.IsMinimizable = false;

OverlappedPresenter를 수정하기

OverlappedPresenter는 다양한 방법으로 구성할 수 있는 유연한 발표자입니다.

Create* 메서드를 사용하면 기본 속성 설정을 사용하여 겹치는 발표자를 만들거나 특정 용도로 속성 설정이 미리 구성된 발표자를 만들 수 있습니다.

이 표에서는 각 메서드에서 OverlappedPresenter 개체를 만들 때 구성 속성이 설정되는 방법을 보여줍니다.

재산	Create	CreateForContextMenu	CreateForDialog	CreateForToolWindow
HasBorder	true	true	true	true
HasTitleBar	true	false	true	true
IsAlwaysOnTop	false	false	false	false
최대화 가능 여부	true	false	false	true
IsMinimizable	true	false	false	true
IsModal	false	false	false	false
IsResizable	true	false	false	true

응용 발표자는 라이브 오브젝트입니다. AppWindow.Presenter 개체의 속성 변경은 즉시 적용됩니다. 이러한 변경 내용을 알리는 이벤트는 없지만 언제든지 현재 값의 속성을 확인할 수 있습니다.

HasBorder 및 HasTitleBar 속성은 읽기 전용입니다. SetBorderAndTitleBar 메서드(SetBorderAndTitleBar(bool hasBorder, bool hasTitleBar))를 호출하여 이러한 값을 설정할 수 있습니다. OverlappedPresenter에는 테두리가 없는 제목 표시줄이 있을 수 없습니다. 즉, hasTitleBar 매개 변수가 true라면, hasBorder 매개 변수도 true이어야 합니다. 그렇지 않으면 이 메시지와 함께 예외가 발생합니다.

The parameter is incorrect.
Invalid combination: Border=false, TitleBar=true.

도구 모음에서 최대화 단추를 숨기도록 을 설정합니다. 이 작업을 수행하는 것이 좋습니다. PreferredMaximumHeight나 PreferredMaximumWidth 속성을 설정하면 이러한 속성이 최대화된 상태에서도 창 크기를 제한하기 때문입니다. 이는 Maximize 메서드 호출에 영향을 주지 않습니다.

도구 모음에서 최소화 단추를 숨기도록 을 설정합니다. 이는 Minimize 메서드 호출에 영향을 주지 않습니다.

크기 조정 컨트롤을 숨기고 사용자가 창 크기를 조정하지 못하도록 하려면 을 설정합니다. 이는 AppWindow.Resize 메서드에 대한 호출에 영향을 주지 않습니다.

다른 창 위에 이 창을 유지하려면 을 설정합니다. 메서드를 AppWindow.MoveInZOrder* 호출하면 이 속성이 true일 경우에도 창의 z 순서가 변경됩니다.

PreferredMaximumHeight 및 PreferredMaximumWidth를 설정하여 사용자가 창을 확장할 수 있는 최대 크기를 제한합니다. 이러한 속성은 최대화된 상태에서도 창 크기를 제한하므로 최대 크기 속성을 설정하는 경우 설정하는 IsMaximizablefalse 것이 좋습니다. 이러한 속성은 에 대한 호출에도 영향을 미칩니다AppWindow. 크기 조정; 창의 크기는 지정된 최대 높이 및 너비보다 크지 않습니다.

PreferredMinimumHeight 및 PreferredMinimumWidth를 설정하여 사용자가 창을 축소할 수 있는 최소 크기를 설정합니다. 이러한 속성은 에 대한 호출에도 영향을 미칩니다AppWindow. 크기 조정; 창의 크기는 지정된 최소 높이 및 너비보다 작지 않습니다.

모달 창

IsModal을 true로 설정하여 모달 창을 만들 수 있습니다. 모달 창은 닫을 때까지 소유자 창 과의 상호 작용을 차단하는 별도의 창입니다. 그러나 모달 창을 만들려면 소유자 창도 설정해야 합니다. 그렇지 않으면 다음 메시지와 함께 예외가 throw됩니다.

The parameter is incorrect.

The window should have an owner when IsModal=true.

WinUI 앱에서 소유자 창을 설정하려면 Win32 interop가 필요합니다. 자세한 내용 및 예제 코드는 AppWindow WinUI 3 갤러리 샘플 앱의 페이지를 참조하세요.

• WinUI 3 갤러리 앱 시작
• GitHub에서 ModalWindow.xaml.cs를 엽니다

발표자 지정

발표자는 한 번에 하나의 창에만 적용할 수 있습니다. 동일한 발표자를 두 번째 창에 적용하려고 하면 예외가 발생합니다. 즉, 창이 여러 개 있고 각 창을 특정 프레젠테이션 모드로 전환하려면 동일한 종류의 여러 발표자를 만든 다음 각각을 자체 창에 적용해야 합니다.

새 발표자가 적용될 때(AppWindow. 발표자 속성이 변경되면) 앱에는 영향을 받는 AppWindow의 .Changed 이벤트와 함께 알림이 제공되며, 이때 AppWindow.AppWindowChangedEventArgs.DidPresenterChange 속성이 설정됩니다.

팁 (조언)

수정된 발표자를 적용하고 발표자 간에 변경을 허용하는 경우 수정된 발표자에 대한 참조를 유지하여 다시 적용 AppWindow할 수 있도록 해야 합니다.

이 예제에서는 다음의 방법을 보여줍니다.

• AppWindow.Presenter 속성을 사용하여 현재의 발표자를 가져옵니다.
• AppWindowPresenter.Kind 속성을 사용하여 현재 적용된 구성 종류를 확인합니다.
• SetPresenter를 호출하여 현재 구성을 변경합니다.

여기서 발표자는 창의 생성자에 생성, 수정 및 적용됩니다.

OverlappedPresenter presenter = OverlappedPresenter.Create();
presenter.PreferredMinimumWidth = 420;
presenter.PreferredMinimumHeight = 550;
AppWindow.SetPresenter(presenter);

창의 콘텐츠인 페이지에서AppWindow에 대한 참조와 적용된 발표자를 가져올 수 있습니다.

AppWindow appWindow;
OverlappedPresenter modifiedPresenter;

private void AppWindowPage_Loaded(object sender, RoutedEventArgs e)
{
    appWindow = AppWindow.GetFromWindowId(XamlRoot.ContentIslandEnvironment.AppWindowId);
    modifiedPresenter = (OverlappedPresenter)appWindow.Presenter;

    appWindow.Changed += AppWindow_Changed;
}

private void AppWindow_Changed(AppWindow sender, AppWindowChangedEventArgs args)
{
    if (args.DidPresenterChange)
    {
        // ConfigText is a TextBox control defined in XAML for the page.
        ConfigText.Text = appWindow.Presenter.Kind.ToString();
    }
}

private void CompactOverlayButton_Click(object sender, RoutedEventArgs e)
{
    if (appWindow.Presenter.Kind != AppWindowPresenterKind.CompactOverlay)
    {
        appWindow.SetPresenter(CompactOverlayPresenter.Create());
        fullScreenButton.IsChecked = false;
    }
    else
    {
        appWindow.SetPresenter(modifiedPresenter);
    }
}

private void FullScreenButton_Click(object sender, RoutedEventArgs e)
{
    if (appWindow.Presenter.Kind != AppWindowPresenterKind.FullScreen)
    {
        appWindow.SetPresenter(FullScreenPresenter.Create());
        compactOverlayButton.IsChecked = false;
    }
    else
    {
        appWindow.SetPresenter(modifiedPresenter);
    }
}

UI 프레임워크 및 HWND 상호 운용성

AppWindow 클래스는 앱의 어떤 최상위 HWND에도 사용할 수 있습니다. 즉, 데스크톱 UI 프레임워크(WinUI 포함)로 작업하는 경우 해당 프레임워크의 진입점을 사용하여 창을 만들고 콘텐츠를 연결할 수 있습니다. 해당 UI 프레임워크를 사용하여 창을 만든 후에는 Windows 앱 SDK 제공된 창 interop 함수(아래 참조)를 사용하여 해당 AppWindow 및 해당 메서드, 속성 및 이벤트에 액세스할 수 있습니다.

UI 프레임워크를 사용하는 경우에도 사용 AppWindow 의 이점 중 일부는 다음과 같습니다.

• 간단한 제목 표시줄 사용자 지정; 기본적으로 Windows 11 UI(둥근 모서리, 스냅 그룹 플라이아웃)를 유지 관리합니다.
• 시스템에서 제공하는 전체 화면 및 소형 오버레이(화면 속 화면) 기능.
• 핵심 Win32 창 개념 중 일부에 대한 WinRT(Windows 런타임) API 표면입니다.

1.3 이전 버전의 Windows 앱 SDK AppWindow 가져오기(또는 다른 데스크톱 앱 프레임워크)

Window.AppWindow 속성은 Windows 앱 SDK 버전 1.3 이상에서 사용할 수 있습니다. 이전 버전의 경우 이 섹션에서 기능적으로 동등한 코드 예제를 사용할 수 있습니다.

C#. 창 interop 함수에 대한 .NET 래퍼는 Microsoft.UI.Win32Interop 클래스의 메서드로 구현됩니다. 또한 .NET 앱에서 interop API 호출 참조하세요.

C++. Interop 함수는 winrt/Microsoft.ui.interop.h 헤더 파일에 정의 되어 있습니다.

아래 코드 예제 섹션에는 실제 소스 코드가 표시됩니다. 하지만 기존 창이 지정된 경우 개체를 AppWindow 검색하는 방법은 다음과 같습니다.

1. 아직 없는 경우 기존 창 개체(UI 프레임워크용)에 대한 HWND를 검색합니다.
2. 해당 HWND를 GetWindowIdFromWindow interop 함수에 전달하여 WindowId를 검색합니다.
3. 해당 WindowId를 정적 AppWindow.GetFromWindowId 메서드에 전달하여 AppWindow를 검색합니다.

// MainWindow.xaml.cs
private void myButton_Click(object sender, RoutedEventArgs e)
{
    // Retrieve the window handle (HWND) of the current (XAML) WinUI window.
    var hWnd =
        WinRT.Interop.WindowNative.GetWindowHandle(this);

    // Retrieve the WindowId that corresponds to hWnd.
    Microsoft.UI.WindowId windowId =
        Microsoft.UI.Win32Interop.GetWindowIdFromWindow(hWnd);

    // Lastly, retrieve the AppWindow for the current (XAML) WinUI window.
    Microsoft.UI.Windowing.AppWindow appWindow =
        Microsoft.UI.Windowing.AppWindow.GetFromWindowId(windowId);

    if (appWindow != null)
    {
        // You now have an AppWindow object, and you can call its methods to manipulate the window.
        // As an example, let's change the title text of the window.
        appWindow.Title = "Title text updated via AppWindow!";
    }
}

// pch.h
#include "microsoft.ui.xaml.window.h" // For the IWindowNative interface.
#include <winrt/Microsoft.UI.Interop.h> // For the WindowId struct and the GetWindowIdFromWindow function.
#include <winrt/Microsoft.UI.Windowing.h> // For the AppWindow class.

// mainwindow.xaml.cpp
void MainWindow::myButton_Click(IInspectable const&, RoutedEventArgs const&)
{
    // Retrieve the window handle (HWND) of the current (XAML) WinUI window.
    auto windowNative{ this->m_inner.as<::IWindowNative>() };
    HWND hWnd{ 0 };
    windowNative->get_WindowHandle(&hWnd);

    // Retrieve the WindowId that corresponds to hWnd.
    Microsoft::UI::WindowId windowId = 
        Microsoft::UI::GetWindowIdFromWindow(hWnd);

    // Lastly, retrieve the AppWindow for the current (XAML) WinUI window.
    Microsoft::UI::Windowing::AppWindow appWindow = 
        Microsoft::UI::Windowing::AppWindow::GetFromWindowId(windowId);

    if (appWindow)
    {
        // You now have an AppWindow object, and you can call its methods to manipulate the window.
        // As an example, let's change the title text of the window.
        appWindow.Title(L"Title text updated via AppWindow!");
    }
}

AppWindow 사용하는 방법에 대한 자세한 예제는 Windowing 갤러리 샘플 참조하세요.

제한점

Windows 앱 SDK 현재 AppWindow UI 프레임워크 콘텐츠를 연결하는 메서드를 제공하지 않습니다.

관련 항목

• 윈도우 관리 개요
• 여러 창 표시
• 제목 표시줄 사용자 지정
• DisplayArea 클래스
• 윈도우 기능 마이그레이션
• .NET 앱에서 interop API를 호출합니다
• 창 핸들(HWND) 획득하기
• 윈도우 갤러리 샘플
• WinUI 갤러리 - 창