Freigeben über


AppWindow Klasse

Definition

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 AppWindow
Public NotInheritable Class AppWindow
Vererbung
Object Platform::Object IInspectable AppWindow
Attribute

Hinweise

Wichtig

Anpassungs-APIs für Titelleisten werden teilweise unter Windows 10 unterstützt, da Windows App SDK 1.2 und unter Windows 11 vollständig unterstützt werden. Überprüfen Sie AppWindowTitleBar.IsCustomizationSupported in Ihrem Code, bevor Sie diese APIs aufrufen, um sicherzustellen, dass Ihre App nicht in anderen Versionen von Windows abstürzt. Weitere Informationen finden Sie unter Anpassung der Titelleiste.

Eigenschaften

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.

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

AssociateWithDispatcherQueue(DispatcherQueue)

Ordnet das App-Fenster der angegebenen Verteilerwarteschlange zu.

Create()

Erstellt ein App-Fenster mit den Formatvorlagen und Eigenschaften, die auf die der Standard-OverlappedPresenterfestgelegt sind.

Create(AppWindowPresenter, WindowId, DispatcherQueue)

Erstellt ein Fenster mit Formatvorlagen und Eigenschaften, die in der angegebenen AppWindowPresenterdefiniert sind, die dem angegebenen Fenster übergeordnet sind und dem angegebenen DispatcherQueuezugeordnet sind.

Create(AppWindowPresenter, WindowId)

Erstellt ein Fenster mit Formatvorlagen und Eigenschaften, wie in der angegebenen AppWindowPresenter definiert und dem angegebenen Fenster übergeordnet.

Create(AppWindowPresenter)

Erstellt ein Fenster mit Formatvorlagen und Eigenschaften, wie in der angegebenen AppWindowPresenterdefiniert.

Destroy()

Versucht, das App-Fenster zu zerstören.

GetFromWindowId(WindowId)

Gibt den AppWindow mit dem angegebenen WindowIdzurück, falls verfügbar. Gibt null zurück, wenn die WindowId nicht mit einem gültigen Fenster abgeglichen werden kann.

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.

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.

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

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.

Gilt für:

Weitere Informationen