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

ApIs zur Anpassung von Titelleisten werden in Windows 10 seit Windows App SDK 1.2 teilweise unterstützt und auf Windows 11 vollständig unterstützt. Sie sollten AppWindowTitleBar.IsCustomizationSupported in Ihrem Code aktivieren, bevor Sie diese APIs aufrufen, um sicherzustellen, dass Ihre App nicht unter 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

Ruft einen Wert ab, der angibt, ob dieses Fenster in verschiedenen Systemdarstellungen wie ALT+TAB und Taskleiste angezeigt wird, oder legt diesen fest.

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

Ruft den angezeigten Titel des App-Fensters ab oder legt diese fest.

TitleBar

Ruft die Titelleiste des App-Fensters ab.

Methoden

AssociateWithDispatcherQueue(DispatcherQueue)

Ordnet das App-Fenster der angegebenen Verteilerwarteschlange zu.

Create()

Erstellt ein App-Fenster, in dem die Formatvorlagen und Eigenschaften auf die des Standardfensters OverlappedPresenterfestgelegt sind.

Create(AppWindowPresenter)

Erstellt ein Fenster mit Stilen und Eigenschaften, wie im angegebenen AppWindowPresenterdefiniert.

Create(AppWindowPresenter, WindowId)

Erstellt ein Fenster mit Stilen und Eigenschaften, wie im angegebenen AppWindowPresenter definiert und dem angegebenen Fenster übergeordnet.

Create(AppWindowPresenter, WindowId, DispatcherQueue)

Erstellt ein Fenster mit Stilen und Eigenschaften, die im angegebenen AppWindowPresenterdefiniert sind, dem angegebenen Fenster übergeordnet und dem angegebenen DispatcherQueuezugeordnet sind.

Destroy()

Versucht, das App-Fenster zu zerstören.

GetFromWindowId(WindowId)

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

Hide()

Blendet das Fenster vor allen UX-Darstellungen im System aus, hält das Objekt jedoch am Leben.

Move(PointInt32)

Verschiebt das Fenster an den angegebenen Punkt in den Bildschirmkoordinaten.

MoveAndResize(RectInt32)

Verschiebt das Fenster an den angegebenen Punkt in den Bildschirmkoordinaten und legt es auf die angegebene Größe fest.

MoveAndResize(RectInt32, DisplayArea)

Verschiebt das Fenster an den angegebenen Punkt innerhalb des angegebenen Anzeigebereichs und legt es auf die angegebene Größe fest.

MoveInZOrderAtBottom()

Verschiebt das aktuelle Fenster in das untere Fenster in der Z-Reihenfolge.

MoveInZOrderAtTop()

Verschiebt das aktuelle Fenster in das obere Fenster in der Z-Reihenfolge.

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 an die angegebene Größe für den Clientbereich.

SetIcon(IconId)

Legt das Symbol für das Fenster unter Verwendung der angegebenen Symbol-ID fest.

SetIcon(String)

Legt das Symbol für das Fenster unter Verwendung 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 oder Nicht-Aktivieren an.

ShowOnceWithRequestedStartupState()

Zeigt das Fenster mit dem Standard-Referenten im angeforderten Zustand an.

Ereignisse

Changed

Tritt auf, wenn sich eine Eigenschaft des Fensters geändert hat und sich das System vorerst 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