AppWindow Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen vom System verwalteten Container für den Inhalt einer App dar.
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 AppWindowPublic NotInheritable Class AppWindow- Vererbung
- Attribute
Hinweise
Important
Anpassungs-APIs für Titelleisten werden teilweise für Windows 10 unterstützt, da Windows App SDK 1.2 und vollständig auf Windows 11 unterstützt werden. Sie sollten "AppWindowTitleBar.IsCustomizationSupported" in Ihrem Code überprüfen, bevor Sie diese APIs aufrufen, um sicherzustellen, dass Ihre App bei anderen Versionen von Windows nicht abstürzt. Weitere Informationen finden Sie unter Anpassung der Titelleiste .
Eigenschaften
| Name | Beschreibung |
|---|---|
| ClientSize |
Ruft die aktuelle Größe des Clientbereichs des Fensters in Win32-Clientkoordinaten ab. |
| DispatcherQueue |
Ruft die Verteilerwarteschlange ab, die dem App-Fenster zugeordnet ist. |
| Id |
Ruft den Bezeichner für das App-Fenster ab. |
| IsShownInSwitchers |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Fenster in verschiedenen Systemdarstellungen angezeigt wird, z. B. ALT+TAB und Taskleiste. |
| IsVisible |
Ruft einen Wert ab, der angibt, ob das Fenster angezeigt wird. |
| OwnerWindowId |
Ruft den Bezeichner des Besitzers dieses Fensters ab; oder 0, wenn nicht im Besitz. |
| PersistedStateId |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| PlacementRestorationBehavior |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| Position |
Ruft die aktuelle Position des Fensters in Bildschirmkoordinaten ab. |
| Presenter |
Ruft den aktuell angewendeten Referenten für das App-Fenster ab. |
| Size |
Ruft die aktuelle Größe des Fensters in Bildschirmkoordinaten ab. |
| Title |
Dient zum Abrufen oder Festlegen des angezeigten Titels des App-Fensters. |
| TitleBar |
Ruft die Titelleiste des App-Fensters ab. |
Methoden
| Name | Beschreibung |
|---|---|
| AssociateWithDispatcherQueue(DispatcherQueue) |
Ordnet das App-Fenster der angegebenen Verteilerwarteschlange zu. |
| Create() |
Erstellt ein App-Fenster mit den Formatvorlagen und Eigenschaften, die auf die der Standardeinstellung |
| Create(AppWindowPresenter, WindowId, DispatcherQueue) |
Erstellt ein Fenster mit Formatvorlagen und Eigenschaften, die im angegebenen Fenster definiert sind und dem angegebenen |
| Create(AppWindowPresenter, WindowId) |
Erstellt ein Fenster mit Formatvorlagen und Eigenschaften gemäß der Definition im angegebenen |
| Create(AppWindowPresenter) |
Erstellt ein Fenster mit Formatvorlagen und Eigenschaften gemäß der Definition im angegebenen |
| Destroy() |
Versucht, das App-Fenster zu zerstören. |
| GetCurrentPlacement() |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| GetFromWindowId(WindowId) |
Gibt den |
| Hide() |
Blendet das Fenster aus allen UX-Darstellungen im System aus, hält das Objekt aber aktiv. |
| Move(PointInt32) |
Verschiebt das Fenster in Bildschirmkoordinaten zum angegebenen Punkt. |
| MoveAndResize(RectInt32, DisplayArea) |
Verschiebt das Fenster an den angegebenen Punkt innerhalb des angegebenen Anzeigebereichs und legt es auf die angegebene Größe fest. |
| MoveAndResize(RectInt32) |
Verschiebt das Fenster an den angegebenen Punkt in Bildschirmkoordinaten und legt es auf die angegebene Größe fest. |
| MoveInZOrderAtBottom() |
Verschiebt das aktuelle Fenster in der Z-Reihenfolge in das untere Fenster. |
| MoveInZOrderAtTop() |
Verschiebt das aktuelle Fenster in der Z-Reihenfolge in das obere Fenster. |
| MoveInZOrderBelow(WindowId) |
Verschiebt das aktuelle Fenster unter das angegebene Fenster in der Z-Reihenfolge. |
| Resize(SizeInt32) |
Ändert die Größe des Fensters auf die angegebene Größe. |
| ResizeClient(SizeInt32) |
Ändert die Größe des Fensters entsprechend der angegebenen Größe für den Clientbereich. |
| SaveCurrentPlacement() |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| SaveCurrentPlacementForAllPersistedStateIds() |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| SetCurrentPlacement(AppWindowPlacementDetails, Boolean) |
Stellt einen vom System verwalteten Container für den Inhalt einer App dar. |
| SetIcon(IconId) |
Legt das Symbol für das Fenster mithilfe der angegebenen Symbol-ID fest. |
| SetIcon(String) |
Legt das Symbol für das Fenster mithilfe des angegebenen Symbolpfads fest. |
| SetPresenter(AppWindowPresenter) |
Wendet den angegebenen Referenten auf das Fenster an. |
| SetPresenter(AppWindowPresenterKind) |
Wendet die angegebene Referentenart auf das Fenster an. |
| SetTaskbarIcon(IconId) |
Legt das Symbol für die Taskleiste mithilfe der angegebenen Symbol-ID fest. |
| SetTaskbarIcon(String) |
Legt das Symbol für die Taskleiste mithilfe des angegebenen Symbolpfads fest. |
| SetTitleBarIcon(IconId) |
Legt das Symbol für die Fenstertitelleiste mithilfe der angegebenen Symbol-ID fest. |
| SetTitleBarIcon(String) |
Legt das Symbol für die Fenstertitelleiste mithilfe des angegebenen Symbolpfads fest. |
| Show() |
Zeigt das Fenster an und aktiviert es. |
| Show(Boolean) |
Zeigt das Fenster mit einer Option zum Aktivieren an. |
| ShowOnceWithRequestedStartupState() |
Zeigt das Fenster mit dem Standardreferent im angeforderten Zustand an. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Changed |
Tritt auf, wenn sich eine Eigenschaft des Fensters geändert hat und sich das System in einem "stabilen Zustand" befindet. |
| Closing |
Tritt auf, wenn ein Fenster über ein Systemangebot geschlossen wird. |
| Destroying |
Tritt auf, wenn ein Fenster zerstört wird. |