Window Klasse

Definition

Namespace:

Windows.UI.Xaml

Stellt ein Anwendungsfenster dar.

public ref class Window sealed

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

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

Public NotInheritable Class Window

Vererbung

Object Platform::Object IInspectable Window

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Codebeispiel wird die OnLaunched-Methode außer Kraft gesetzt, die für die leere Anwendungsvorlage in Microsoft Visual Studio generiert wurde. Dieser Code veranschaulicht typische Verwendungsmuster für die Eigenschaften Current und Content und die Activate-Methode .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Hinweise

Diese Klasse stellt das Fenster der aktuellen Anwendung dar. Auf die gleiche Weise wie die statische Application-Eigenschaft gibt die statische Current-Eigenschaft das App-Fensterobjekt zurück. Von diesem Objekt aus kann eine App den Dispatcher verwenden oder die Größe des Window über die Bounds-Eigenschaft bestimmen. Die häufigste Verwendung für Window besteht darin, ein UIElement auf den Inhalt festzulegen, der die App-Benutzeroberfläche darstellt. Dies geschieht normalerweise im Rahmen der App-Aktivierung (z. B. in der OnLaunched-Überschreibung ).) Sie können diesen Fensterinhalt während der gesamten Lebensdauer des Fensters ändern.

Es gibt keine XAML-Darstellung der Window-Klasse, da sie kein Steuerelement ist.

Ein Window-Objekt stellt lediglich Informationen aus CoreWindow dar, die wiederum auf das vom System erstellte Fenster verweisen.

Stellen Sie sicher, dass Sie Aktivieren für jedes Fenster aufrufen, das Sie bei der ersten Aktivierung verwenden. Wenn Sie die Standard-App-Vorlagen von Microsoft Visual Studio verwenden, ist das Aufrufen von Window.Activate Teil des anfänglichen Codes in der CodeBehind-Datei app.xaml.

Die LayoutAwarePage-Klasse, die Teil einiger Anwendungsvorlagen in Microsoft Visual Studio ist, verfügt über die Behandlung für das SizeChanged-Ereignis , das verwendet wird, um visuelle Zustände nachzuverfolgen, die den Werten von ApplicationViewState entsprechen. LayoutAwarePage verfügt auch über Code, der Grenzen überprüft und diesen Wert verwendet, um zu beeinflussen, wie seitenweite Eingabeereignisse behandelt werden.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1703	15063	Compositor
1903	18362	UIContext

Zusätzliche Schnittstellenmber

IXamlSourceTransparency.IsBackgroundTransparent

Ruft einen Wert ab, der angibt, ob der Hintergrund aller DesktopWindowXamlSource-Objekte im aktuellen Thread transparent ist, oder legt diesen fest.

Eigenschaften

Bounds	Ruft einen Rect-Wert ab, der den Ursprung, die Höhe und die Breite des Clientbereichs des Fensters in geräteunabhängigen Pixeln (DIPs) enthält.
Compositor	Ruft den Compositor für dieses Fenster ab.
Content	Ruft den visuellen Stamm eines Anwendungsfensters ab oder legt diese fest.
CoreWindow	Ruft ein internes Kernobjekt für das Anwendungsfenster ab.
Current	Ruft das Fenster des aktuellen Threads ab.
Dispatcher	Ruft das CoreDispatcher-Objekt für das Window ab, bei dem es sich im Allgemeinen um den CoreDispatcher für den UI-Thread handelt.
UIContext	Ruft den Kontextbezeichner für das Fenster ab.
Visible	Ruft einen Wert ab, der angibt, ob das Fenster sichtbar ist.

Methoden

Activate()	Versucht, das Anwendungsfenster zu aktivieren, indem es in den Vordergrund bezieht und der Eingabefokus darauf festgelegt wird.
Close()	Schließt das Anwendungsfenster.
SetTitleBar(UIElement)	Bewirkt, dass ein XAML-Element mit dem System interagiert, als wäre es die Titelleiste.

Ereignisse

Activated	Tritt auf, wenn das Fenster erfolgreich aktiviert wurde.
Closed	Tritt auf, wenn das Fenster geschlossen wurde.
SizeChanged	Tritt auf, wenn das App-Fenster zuerst gerendert wurde oder seine Renderinggröße geändert hat.
VisibilityChanged	Tritt auf, wenn sich der Wert der Visible-Eigenschaft ändert.

Weitere Informationen

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Behandeln der App-Aktivierung