Application.MainWindow Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft ab oder legt das Hauptfenster der Anwendung fest.

public:
 property System::Windows::Window ^ MainWindow { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };

public System.Windows.Window MainWindow { get; set; }

member this.MainWindow : System.Windows.Window with get, set

Public Property MainWindow As Window

Eigenschaftswert

Window

A Window that is designated as the main application window.

Ausnahmen

InvalidOperationException

MainWindow wird aus einer Anwendung festgelegt, die in einem Browser gehostet wird, z. B. von XAML-Browseranwendungen (XBAPs).

Beispiele

Das folgende Beispiel zeigt, wie Sie das Hauptanwendungsfenster finden.

// Get the main window
Window mainWindow = this.MainWindow;

' Get the main window
Dim mainWindow As Window = Me.MainWindow

Das folgende Beispiel zeigt, wie Sie die Verwendung von XAML festlegen MainWindow .

<Application 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    StartupUri="StartupWindow.xaml"
    >
  <Application.MainWindow>
    <NavigationWindow Source="MainPage.xaml" Visibility="Visible"></NavigationWindow>
  </Application.MainWindow>
</Application>

Das folgende Beispiel zeigt, wie sie den Code während des MainWindow Anwendungsstarts instanziieren.

public partial class App : Application
{
    void App_Startup(object sender, StartupEventArgs e)
    {
        MainWindow window = new MainWindow();
        window.Show();
    }
}

Partial Public Class App
    Inherits Application
    Private Sub App_Startup(ByVal sender As Object, ByVal e As StartupEventArgs)
        Dim window As New MainWindow()
        window.Show()
    End Sub
End Class

Hinweise

MainWindow wird automatisch mit einem Verweis auf das erste Window Objekt festgelegt, das in der AppDomainInstanziierung instanziiert werden soll.

Sie können ein anderes Hauptfenster angeben, indem Sie der MainWindowMainWindow Eigenschaft ein anderes Windows Objekt zuweisen.

Wenn die ShutdownMode Eigenschaft des Application Objekts auf festgelegt OnMainWindowCloseist, wird das Schließen des Hauptfensters dazu führen, dass die Anwendung heruntergefahren wird.

Es ist möglich, die MainWindow Eigenschaft aus XAML festzulegen, wenn das Hauptfenster einer Anwendung nicht das Fenster ist, das durch Festlegen der StartupUri Eigenschaft in XAML erzeugt wird. Die beiden Einschränkungen des XAML-Ansatzes sind:

• Sie können entweder nur XAML Window oder nur XAML NavigationWindow als Hauptfenster angeben.

• Sie müssen die Visibility Eigenschaft des angegebenen Fensters festlegen, andernfalls wird sie nicht angezeigt.

Der Verweis auf das erste Window objekt, das instanziiert werden soll, wird auch als erstes Element zur Windows Auflistung hinzugefügt. Wenn MainWindow anschließend ein Verweis auf eine andere Windowfestgelegt wird, ändert sich die Position des Elements mit dem Verweis auf das Hauptfenster, während die Reihenfolge der Elemente Windows unverändert bleibt. Verwenden Sie MainWindow daher immer den Verweis auf das Hauptfenster anstelle des ersten Elements in Windows.

Hinweis

Wenn es sich bei dem Hauptfenster um ein NavigationWindow, und Sie einen bestimmten Zugriff auf NavigationWindow Member benötigen, müssen Sie den Wert in MainWindow " umwandeln.NavigationWindow

Diese Eigenschaft ist nur über den Thread verfügbar, der das Application Objekt erstellt hat.

Weitere Informationen

• Exit