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

備註

重要

因為 Windows App SDK 1.2 和 Windows 11 上完全支援標題列自定義 API，因此部分支援 Windows 10。 您應該先檢查 AppWindowTitleBar.IsCustomizationSupported 程式代碼中，再呼叫這些 API，以確保您的應用程式不會在其他版本的 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)	使用指定的圖示標識碼，設定視窗的圖示。
SetIcon(String)	使用指定的圖示路徑，設定視窗的圖示。
SetPresenter(AppWindowPresenter)	將指定的演示者套用至視窗。
SetPresenter(AppWindowPresenterKind)	將指定的演示者種類套用至視窗。
Show()	顯示視窗並加以啟動。
Show(Boolean)	顯示視窗，其中包含啟動視窗的選項。
ShowOnceWithRequestedStartupState()	顯示具有要求狀態之預設演示者的視窗。

事件

Changed	發生於視窗的 屬性已變更，且系統目前處於「穩定狀態」時。
Closing	當視窗透過系統能供性關閉時發生。
Destroying	當視窗被終結時發生。

另請參閱

• 管理應用程式視窗
• 標題列自定義