Application.MainWindow 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定應用程式的主視窗。

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

屬性值

Window

指定做為主應用程式視窗的 Window。

例外狀況

InvalidOperationException

MainWindow 是從裝載在瀏覽器中的應用程式設定，例如 XAML 瀏覽器應用程式 (XBAP) 。

範例

下列範例示範如何尋找主應用程式視窗。

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

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

下列範例示範如何使用 XAML 進行設定 MainWindow 。

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

下列範例示範如何在應用程式啟動期間具現化 MainWindow 程式碼中的 。

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

備註

MainWindow會自動設定 ，並參考要具現化的第 AppDomain 一個 Window 物件。

您可以藉由將 MainWindow 另一個物件指派給 MainWindow 屬性，來指定不同的 Windows 主視窗。

ShutdownMode如果 物件的 屬性 Application 設定 OnMainWindowClose 為 ，關閉主視窗會導致應用程式關閉。

如果應用程式的主視窗不是透過在 XAML 中設定 屬性所產生的視窗，就可以從 XAML 設定 屬性來設定 MainWindow StartupUri 屬性。 XAML 方法的兩個限制如下：

• 您可以指定僅限 Window XAML 或僅限 NavigationWindow XAML 做為主視窗。

• 您必須設定 Visibility 您所指定的視窗屬性，否則不會顯示它。

要具現化之第一個 Window 物件的參考也會新增為集合的第一個專案 Windows 。 如果 MainWindow 後續使用不同 Window 的參考來設定 ，則專案與主視窗參考的位置將會變更，而 中的 Windows 專案順序會維持不變。 因此，一律使用 MainWindow 來參考主視窗，而不是 中的 Windows 第一個專案。

注意

如果主視窗是 NavigationWindow ，而且您需要成員的特定存取 NavigationWindow 權，則必須將 的值 MainWindow NavigationWindow 轉換成 。

這個屬性只能從建立 Application 物件的執行緒取得。

另請參閱

• Exit