Application.MainWindow Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia główne okno aplikacji.

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

Wartość właściwości

Window

Element Window wyznaczony jako główne okno aplikacji.

Wyjątki

InvalidOperationException

MainWindow element jest ustawiany z aplikacji hostowanej w przeglądarce, takiej jak aplikacje przeglądarki XAML (XBAPs).

Przykłady

W poniższym przykładzie pokazano, jak znaleźć główne okno aplikacji.

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

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

W poniższym przykładzie pokazano, jak ustawić MainWindow przy użyciu języka 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>

W poniższym przykładzie pokazano, jak utworzyć wystąpienie MainWindow kodu w kodzie podczas uruchamiania aplikacji.

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

Uwagi

MainWindow element jest ustawiany automatycznie przy użyciu odwołania do pierwszego Window obiektu, który ma zostać utworzone w obiekcie AppDomain.

Możesz określić inne okno główne, ustawiając MainWindow przypisanie innego Windows obiektu do MainWindow właściwości.

ShutdownMode Jeśli właściwość Application obiektu jest ustawiona na OnMainWindowClose, zamknięcie okna głównego powoduje zamknięcie aplikacji.

Istnieje możliwość ustawienia MainWindow właściwości z kodu XAML, jeśli główne okno aplikacji nie jest oknem generowanym przez ustawienie StartupUri właściwości w języku XAML. Dwa ograniczenia podejścia XAML są następujące:

• Jako główne okno można określić tylko Window język XAML lub tylko NavigationWindow XAML.

• Musisz ustawić Visibility właściwość określonego okna, w przeciwnym razie nie będzie wyświetlana.

Odwołanie do pierwszego Window obiektu, który ma zostać utworzone, jest również dodawane jako pierwszy element do Windows kolekcji. Jeśli MainWindow element zostanie później ustawiony z odwołaniem do innego Windowelementu , pozycja elementu z odwołaniem do okna głównego zmieni się, podczas gdy kolejność elementów pozostaje Windows taka sama. W związku z tym zawsze należy używać MainWindow polecenia , aby odwołać się do okna głównego zamiast pierwszego elementu w elemencie Windows.

Uwaga

Jeśli główne okno to NavigationWindow, a potrzebujesz określonego dostępu do NavigationWindow elementów członkowskich, musisz rzutować wartość MainWindow na NavigationWindow.

Ta właściwość jest dostępna tylko z wątku Application , który utworzył obiekt.

Zobacz też

• Exit