AppWindow 클래스

정의

네임스페이스:

Microsoft.UI.Windowing

앱 콘텐츠에 대한 시스템 관리 컨테이너를 나타냅니다.

public ref class AppWindow sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppWindow final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppWindow

Public NotInheritable Class AppWindow

상속

Object Platform::Object IInspectable AppWindow

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

설명

중요하다

제목 표시줄 사용자 지정 API는 Windows 앱 SDK 1.2 이후 Windows 10에서 부분적으로 지원되며 Windows 11에서 완전히 지원됩니다. 이러한 API를 호출하기 전에 코드에서 AppWindowTitleBar.IsCustomizationSupported 확인하여 앱이 다른 버전의 Windows에서 충돌하지 않도록 해야 합니다. 자세한 내용은 제목 표시줄 사용자 지정 참조하세요.

속성

ClientSize	Win32 클라이언트 좌표에서 창의 클라이언트 영역의 현재 크기를 가져옵니다.
DispatcherQueue	앱 창과 연결된 디스패처 큐를 가져옵니다.
Id	앱 창의 식별자를 가져옵니다.
IsShownInSwitchers	이 창이 ALT+TAB 및 작업 표시줄과 같은 다양한 시스템 표현에 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
IsVisible	창이 표시되는지 여부를 나타내는 값을 가져옵니다.
OwnerWindowId	이 창의 소유자 식별자를 가져옵니다. 소유하지 않은 경우 0입니다.
Position	화면 좌표에서 창의 현재 위치를 가져옵니다.
Presenter	앱 창에 대해 현재 적용된 발표자를 가져옵니다.
Size	화면 좌표에서 창의 현재 크기를 가져옵니다.
Title	앱 창의 표시된 제목을 가져오거나 설정합니다.
TitleBar	앱 창의 제목 표시줄을 가져옵니다.

메서드

AssociateWithDispatcherQueue(DispatcherQueue)	앱 창을 지정된 디스패처 큐에 연결합니다.
Create()	스타일 및 속성이 기본 OverlappedPresenter설정된 앱 창을 만듭니다.
Create(AppWindowPresenter, WindowId, DispatcherQueue)	지정된 AppWindowPresenter정의된 대로 지정한 창에 부모로 지정되고 지정된 DispatcherQueue연결된 스타일 및 속성을 사용하여 창을 만듭니다.
Create(AppWindowPresenter, WindowId)	지정된 AppWindowPresenter 정의되고 지정된 창에 부모로 지정된 스타일 및 속성이 있는 창을 만듭니다.
Create(AppWindowPresenter)	지정한 AppWindowPresenter정의된 대로 스타일과 속성이 있는 창을 만듭니다.
Destroy()	앱 창을 삭제하려고 시도합니다.
GetFromWindowId(WindowId)	사용 가능한 경우 지정된 WindowId있는 AppWindow 반환합니다. WindowId 유효한 창과 일치시킬 수 없는 경우 null 반환합니다.
Hide()	시스템의 모든 UX 표현에서 창을 숨기지만 개체를 활성 상태로 유지합니다.
Move(PointInt32)	창을 지정된 화면 좌표 지점으로 이동합니다.
MoveAndResize(RectInt32, DisplayArea)	창을 지정된 표시 영역 내의 지정된 지점으로 이동하고 지정된 크기로 설정합니다.
MoveAndResize(RectInt32)	창을 화면 좌표의 지정된 지점으로 이동하고 지정된 크기로 설정합니다.
MoveInZOrderAtBottom()	현재 창을 Z 순서의 아래쪽 창으로 이동합니다.
MoveInZOrderAtTop()	현재 창을 Z 순서의 위쪽 창으로 이동합니다.
MoveInZOrderBelow(WindowId)	현재 창을 Z 순서의 지정된 창 아래로 이동합니다.
Resize(SizeInt32)	창의 크기를 지정된 크기로 조정합니다.
ResizeClient(SizeInt32)	클라이언트 영역에 대해 지정된 크기에 맞게 창의 크기를 조정합니다.
SetIcon(IconId)	지정된 아이콘 ID를 사용하여 창의 아이콘을 설정합니다.
SetIcon(String)	지정된 아이콘 경로를 사용하여 창의 아이콘을 설정합니다.
SetPresenter(AppWindowPresenter)	지정된 발표자를 창에 적용합니다.
SetPresenter(AppWindowPresenterKind)	지정된 발표자 종류를 창에 적용합니다.
Show()	창을 표시하고 활성화합니다.
Show(Boolean)	활성화 여부에 대한 옵션이 있는 창을 표시합니다.
ShowOnceWithRequestedStartupState()	요청된 상태의 기본 발표자가 있는 창을 표시합니다.

이벤트

Changed	창의 속성이 변경되고 시스템이 당분간 "안정적인 상태"에 있을 때 발생합니다.
Closing	시스템 어도던스를 통해 창을 닫을 때 발생합니다.
Destroying	창이 제거될 때 발생합니다.

추가 정보

• 앱 창 관리
• 제목 표시줄 사용자 지정