Application.MainWindow Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Element Window wyznaczony jako główne okno aplikacji.
Wyjątki
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.