Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Application.MainWindow-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft ab oder legt im Hauptfenster der Anwendung.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Window MainWindow { get; set; }

Eigenschaftswert

Type: System.Windows.Window

Ein Window der als Hauptfenster der Anwendung festgelegt wird.

Exception Condition
InvalidOperationException

MainWindow Wert aus einer Anwendung, die in einem Browser, z. B. gehostet wird ein XAML-Browseranwendungen (XAML browser applications; XBAPs).

MainWindow wird automatisch mit einem Verweis auf die erste festgelegt Window -Objekt in instanziiert werden die AppDomain.

Sie können ein anderes Hauptfenster angeben, indem Sie die Einstellung MainWindow Zuweisen von einem anderen Windows -Objekt die MainWindow Eigenschaft.

Wenn die ShutdownMode Eigenschaft der Application -Objekt OnMainWindowClose, das Hauptfenster schließen, wird die Anwendung beendet.

Es ist möglich, legen Sie die MainWindow Eigenschaft aus XAML, wenn das Hauptfenster einer Anwendung nicht das Fenster ist, die durch Festlegen der StartupUri Eigenschaft im XAML. Die zwei Einschränkungen der XAML Ansatz sind:

  • Geben Sie einen XAML-nur Window oder XAML-nur NavigationWindow wie das Hauptfenster.

  • Sie müssen festlegen, die Visibility -Eigenschaft des Fensters angeben, andernfalls wird dieses nicht angezeigt.

Der Verweis auf das erste Window Objekt instanziiert werden auch als das erste Element hinzugefügt wird der Windows Auflistung. Wenn MainWindow später mit einem Verweis auf ein anderes festgelegt Window, die Position des Elements mit dem Verweis auf das Hauptfenster geändert, während die Reihenfolge der Elemente im Windows bleibt unverändert. Verwenden Sie daher stets MainWindow zum Verweisen auf das Hauptfenster statt des ersten Elements im Windows.

System_CAPS_noteHinweis

Wenn das Hauptfenster ist eine NavigationWindow, und benötigen Sie bestimmte Zugriff auf NavigationWindow Member müssen Sie den Wert der umwandeln MainWindow auf NavigationWindow.

Diese Eigenschaft steht nur in dem Thread, der erstellt die Application Objekt.

Im folgenden Beispiel wird das Hauptfenster der Anwendung zu suchen.

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

Das folgende Beispiel zeigt, wie festgelegt MainWindow mit XAML.

<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 instanziieren der MainWindow im Code während des Anwendungsstarts.

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

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 4.0
Zurück zum Anfang
Anzeigen: