Application.MainWindow Tulajdonság

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállítja az alkalmazás főablakát.

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

Tulajdonság értéke

Window

A Window fő alkalmazásablakként kijelölt ablak.

Kivételek

InvalidOperationException

MainWindow egy böngészőben üzemeltetett alkalmazásból van beállítva, például XAML böngészőalkalmazásokból (XBAP-kből).

Példák

Az alábbi példa bemutatja, hogyan keresheti meg a fő alkalmazásablakot.

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

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

Az alábbi példa bemutatja, hogyan állíthatja be MainWindow az XAML-t.

<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>

Az alábbi példa bemutatja, hogyan lehet példányosítani a kódban az MainWindow alkalmazás indítása során.

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

Megjegyzések

MainWindow automatikusan be van állítva az első Window objektumra mutató hivatkozással, amely AppDomaina .

Másik főablakot úgy adhat meg, hogy MainWindow másik Windows objektumot rendel a MainWindow tulajdonsághoz.

Ha az ShutdownModeApplication objektum tulajdonsága be van állítva OnMainWindowClose, a főablak bezárása miatt az alkalmazás leáll.

A tulajdonságot az XAML-ből lehet beállítani MainWindow , ha az alkalmazás főablaka nem az az ablak, amelyet a StartupUri tulajdonság XAML-ben való beállításával állítanak elő. Az XAML megközelítés két korlátozása:

• Főablakként megadhat csak XAML-t Window vagy csak NavigationWindow XAML-et.

• Be kell állítania a Visibility megadott ablak tulajdonságát, különben az nem jelenik meg.

A példányosítandó első Window objektumra mutató hivatkozás az Windows gyűjtemény első elemeként is megjelenik. Ha MainWindow később egy másik Window hivatkozással van beállítva, az elem helye a főablakra való hivatkozással változik, míg a Windows elemeinek sorrendje változatlan marad. Ezért mindig a MainWindow használatával hivatkozzon a főablakra a Windows első eleme helyett.

Note

Ha a főablak egy NavigationWindow, és konkrét hozzáférésre van szüksége a tagokhoz NavigationWindow , az értéket MainWindowNavigationWindowa következőre kell adnia.

Ez a tulajdonság csak az objektumot létrehozó Application szálból érhető el.

Lásd még

• Exit