Application.MainWindow Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví hlavní okno aplikace.

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

Hodnota vlastnosti

Window

Ten Window je určen jako hlavní okno aplikace.

Výjimky

InvalidOperationException

MainWindow je nastavená z aplikace hostované v prohlížeči, například z aplikací prohlížeče XAML (XBAPs).

Příklady

Následující příklad ukazuje, jak najít hlavní okno aplikace.

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

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

Následující příklad ukazuje, jak nastavit MainWindow pomocí 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>

Následující příklad ukazuje, jak vytvořit instanci MainWindow v kódu během spuštění aplikace.

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

Poznámky

MainWindow je automaticky nastaven s odkazem na první Window objekt, který má být vytvořena v objektu AppDomain.

Nastavením přiřazení jiného Windows objektu MainWindow k vlastnosti můžete zadat jiné hlavní oknoMainWindow.

ShutdownMode Pokud je vlastnost objektu Application nastavena , OnMainWindowClosezavření hlavního okna způsobí vypnutí aplikace.

Vlastnost je možné nastavit MainWindow z XAML, pokud hlavní okno aplikace není okno vytvořené nastavením StartupUri vlastnosti v XAML. Dvě omezení přístupu XAML jsou:

• Jako hlavní okno můžete zadat pouze Window XAML nebo XAML NavigationWindow .

• Musíte nastavit Visibility vlastnost zadaného okna, jinak se nezobrazí.

Odkaz na první Window objekt, který se má vytvořit instance, se také přidá jako první položka do Windows kolekce. Pokud MainWindow je následně nastaven s odkazem na jiný Window, pozice položky s odkazem na hlavní okno se změní, zatímco pořadí položek zůstává Windows stejné. V důsledku toho vždy použijte MainWindow odkaz na hlavní okno místo první položky v Windows.

Poznámka:

Pokud je NavigationWindowhlavním oknem a potřebujete určitý přístup k NavigationWindow členům, budete muset přetypovat hodnotu MainWindow na NavigationWindowhodnotu .

Tato vlastnost je k dispozici pouze z vlákna, které vytvořil objekt Application .

Viz také

• Exit