Freigeben über


Window Klasse

Definition

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

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.IsBackgroundTransparentRuft 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.

Gilt für:

Weitere Informationen