Application.MainWindow Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft das Hauptfenster der Anwendung ab oder legt dieses 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

Ein Window, das als Hauptanwendungsfenster festgelegt ist.

Ausnahmen

InvalidOperationException

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie Das Hauptanwendungsfenster gefunden wird.

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

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

Im folgenden Beispiel wird gezeigt, wie Sie 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>

Im folgenden Beispiel wird gezeigt, 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 ausgeführt werden soll.

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

Wenn die ShutdownMode Eigenschaft des Objekts auf OnMainWindowClosefestgelegt ist, führt das Schließen des Application Hauptfensters dazu, dass die Anwendung heruntergefahren wird.

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

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

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

Der Verweis auf das erste Objekt, das instanziiert werden soll, wird auch als erstes Window Element zur Windows Auflistung hinzugefügt. Wenn MainWindow sie anschließend mit einem Verweis auf einen anderen WindowVerweis festgelegt ist, ändert sich die Position des Elements mit dem Verweis auf das Hauptfenster, während die Reihenfolge der Elemente unverändert Windows 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 benötigen spezifischen Zugriff auf NavigationWindow Mitglieder, müssen Sie den Wert MainWindow von " NavigationWindow1" in "" umwandeln.

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

Siehe auch

• Exit