Freigeben über


Window Klasse

Definition

Stellt das Fenster der aktuellen Anwendung dar.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window
Public Class Window
Vererbung
Object IInspectable Window
Attribute

Beispiele

OnLaunched

Im folgenden Codebeispiel wird die OnLaunched-Methode außer Kraft gesetzt, die für die WinUI in Desktop-Vorlage in Microsoft Visual Studio generiert wurde. Dieser Code veranschaulicht die typische Verwendung der Activate-Methode auf Window.

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

Erstellen eines neuen Fensters

In Ihren Apps können Sie jedes Fenster explizit erstellen. Das Erstellen mehrerer Fenster erfordert das Update 1.0.1 für WindowsAppSDK und ist auf einen einzelnen Thread beschränkt.

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

Sie können auch ein neues Fenster im Markup definieren:

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

mit entsprechendem CodeBehind:

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
var window = new MainWindow();
window.Activate();

Hinweise

Sie können mehrere Window pro Thread in Ihren Apps erstellen. Weitere Informationen finden Sie unter Erstellen eines neuen Fensters in Beispielen.

Window implementiert IWindowNative , um die Interoperabilität über den Window-HWND (WindowHandle) zu aktivieren.

Wird in der Regel verwendet, Window um ein UIElement auf den Inhalt festzulegen, der die App-Benutzeroberfläche darstellt. Dies erfolgt in der Regel im Rahmen der App-Aktivierung (z. B. in der OnLaunched-Überschreibung ) und ermöglicht es Ihnen, den Fensterinhalt während der gesamten Lebensdauer des Fensters zu ändern.

Stellen Sie sicher , dass Sie Aktivieren für alle aufruft, die Window bei der ersten Aktivierung verwendet wurden. Wenn Sie die Standard-App-Vorlagen aus Microsoft Visual Studio verwenden, ist Window.Activate in der CodeBehind-Datei App.xaml enthalten.

Konstruktoren

Window()

Initialisiert eine neue instance der Window-Klasse.

Eigenschaften

AppWindow

Ruft die ab, die AppWindow diesem XAML zugeordnet ist Window.

Bounds

Ruft einen Rect-Wert ab, der die Höhe und Breite des Anwendungsfensters in Einheiten effektiver Pixel (Ansicht) enthält.

Compositor

Ruft den Compositor für dieses Fenster ab.

Content

Ruft den visuellen Stamm eines Anwendungsfensters ab oder legt diese fest.

CoreWindow

Desktop-Apps werden für diese Eigenschaft immer zurückgegeben null .

Current

Desktop-Apps werden für diese Eigenschaft immer zurückgegeben null .

Dispatcher

Gibt immer in einer Windows App SDK-App zurücknull.

Hinweis

Window.Dispatcher kann in zukünftigen Versionen geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen Window.DispatcherQueue .

DispatcherQueue

Ruft das DispatcherQueue -Objekt für das Fenster ab.

ExtendsContentIntoTitleBar

Ruft einen Wert ab, der angibt, ob die Standardtitelleiste des Fensters ausgeblendet werden soll, um Platz für App-Inhalte zu schaffen, oder legt diesen fest.

SystemBackdrop

Ruft den Systemhintergrund ab, der auf dieses angewendet werden soll, oder legt diesen Windowfest. Der Hintergrund wird hinter dem Window Inhalt gerendert.

Title

Ruft eine Zeichenfolge ab, die für den Fenstertitel verwendet wird, oder legt diese fest.

Visible

Ruft einen Wert ab, der angibt, ob das Fenster sichtbar ist.

Methoden

Activate()

Versucht, das Anwendungsfenster zu aktivieren, indem es in den Vordergrund gebracht und der Eingabefokus darauf festgelegt wird.

Close()

Schließt das Anwendungsfenster.

SetTitleBar(UIElement)

Aktiviert das Titelleistenverhalten für ein XAML-Element, wenn ExtendsContentIntoTitleBar ist true.

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 zum ersten Mal 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