Window Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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ück`null`. 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 `Window`fest. 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: