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

Objekt , Window který je určen jako hlavní okno aplikace.

Výjimky

InvalidOperationException

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

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 spouš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 se automaticky nastaví s odkazem na první Window objekt, který se vytvoří v objektu AppDomain.

Můžete určit jiné hlavní okno nastavením MainWindow přiřazení jiného Windows objektu MainWindow vlastnosti.

ShutdownMode Pokud je vlastnost objektu nastavena Application na OnMainWindowClosehodnotu , zavř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. Přístup XAML má dvě omezení:

• Jako hlavní okno můžete zadat buď jen Window XAML, nebo jen NavigationWindow XAML.

• Musíte nastavit Visibility vlastnost okna, kterou zadáte, jinak se nezobrazí.

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

Poznámka

Pokud je NavigationWindowhlavním oknem a potřebujete konkrétní přístup ke NavigationWindow členům, budete muset přetypovat hodnotu MainWindow na NavigationWindow.

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

Viz také

• Exit