Window Klasse

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Stellt ein 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 setzen, die für die WinUI in Desktop-Vorlage in Microsoft Visual Studio generiert wurde. Dieser Code veranschaulicht die typische Verwendung der Activate-Methode für 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 auf Windows App SDK 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();
  }
}

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

Hinweise

Weitere Informationen und Beispiele finden Sie in der Übersicht über Fenster für WinUI und Windows App SDK.

In der Regel wird ein UIElement auf den Inhalt festgelegt, Window der die App-UI darstellt. Dies erfolgt in der Regel als Teil der App-Aktivierung (z. B. in der OnLaunched-Außerkraftsetzung ) und ermöglicht es Ihnen, den Fensterinhalt während der gesamten Lebensdauer des Fensters zu ändern.

Stellen Sie sicher, dass Sie "Activate" für alle Window bei der erstaktivierung verwendeten Dienste aufrufen. Wenn Sie die Standard-App-Vorlagen aus Microsoft Visual Studio verwenden, ist Window.Activate in der App.xaml CodeBehind-Datei enthalten.

Sie können in Ihren Apps mehr als einen Window Thread erstellen. Siehe Anzeigen mehrerer Fenster für Ihre App.

Window implementiert IWindowNative , um die Interoperabilität über den HWND (WindowHandle) des Fensters zu ermöglichen.

Konstruktoren

Name Beschreibung
Window()

Initialisiert eine neue Instanz der Window-Klasse .

Eigenschaften

Name Beschreibung
AppWindow

Ruft den AppWindow zugeordneten XAML-Code Windowab.
Bounds

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

Ruft den Kompositor für dieses Fenster ab.
Content

Dient zum Abrufen oder Festlegen des visuellen Stamms eines Anwendungsfensters.
CoreWindow

[Veraltet] Gibt immer zurück null.
Current

Gibt immer null zurück.
Dispatcher

[Veraltet] Gibt immer zurück null.
DispatcherQueue

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

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Standardtitelleiste des Fensters ausgeblendet werden soll, um Platz für App-Inhalte zu erstellen.
Height

Stellt ein Fenster der aktuellen Anwendung dar.
MaxHeight

Stellt ein Fenster der aktuellen Anwendung dar.
MaxWidth

Stellt ein Fenster der aktuellen Anwendung dar.
MinHeight

Stellt ein Fenster der aktuellen Anwendung dar.
MinWidth

Stellt ein Fenster der aktuellen Anwendung dar.
SystemBackdrop

Ruft den Systemhintergrund ab, der auf diese WindowAngewendet werden soll, oder legt diesen fest. Der Hintergrund wird hinter dem Window Inhalt gerendert.
Title

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die für den Fenstertitel verwendet wird.
Visible

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

Stellt ein Fenster der aktuellen Anwendung dar.

Methoden

Name Beschreibung
Activate()

Versucht, das Anwendungsfenster zu aktivieren, indem es in den Vordergrund gesetzt und der Eingabefokus darauf festgelegt wird.
Close()

Schließt (zerstört) das Anwendungsfenster.
SetTitleBar(UIElement)

Aktiviert das Verhalten der Titelleiste für ein XAML-Element bei Bedarf ExtendsContentIntoTitleBartrue.

Ereignisse

Name Beschreibung
Activated

Tritt auf, wenn das Fenster erfolgreich aktiviert oder deaktiviert wurde.
Closed

Tritt auf, wenn das Fenster geschlossen wurde.
SizeChanged

Tritt auf, wenn sich die Renderinggröße des Fensters geändert hat.
VisibilityChanged

Tritt auf, wenn sich der Wert der Visible-Eigenschaft ändert.

Gilt für:

Weitere Informationen