Application.MainWindow プロパティ

定義

アプリケーションのメイン ウィンドウを取得または設定します。

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

例外

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>

次の例は、アプリケーションの起動時に in コードを 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 は、インスタンス化される最初 Window のオブジェクトへの参照を使用して自動的に AppDomain設定されます。

別のオブジェクトをプロパティに割り当てることで MainWindow 、別 Windows のメイン ウィンドウを MainWindow 指定できます。

オブジェクトのプロパティがShutdownModeApplication設定OnMainWindowCloseされている場合は、メイン ウィンドウを閉じると、アプリケーションがシャットダウンします。

アプリケーションの MainWindow メイン ウィンドウが XAML でプロパティを設定することによって生成されるウィンドウでない場合は、XAML からプロパティを StartupUri 設定できます。 XAML アプローチの 2 つの制限事項は次のとおりです。

  • メイン ウィンドウとして XAML 専用 Window または XAML 専用 NavigationWindow のいずれかを指定できます。

  • 指定した Visibility ウィンドウのプロパティを設定する必要があります。それ以外の場合は表示されません。

インスタンス化される最初 Window のオブジェクトへの参照も、コレクションの最初の項目 Windows として追加されます。 その後、別Windowの参照を使用して設定された場合MainWindow、メイン ウィンドウへの参照を持つ項目の位置は変更されますが、項目Windowsの順序は変わりません。 したがって、常に最初の項目Windowsではなくメイン ウィンドウを参照するために使用MainWindowします。

注意

メイン ウィンドウが 、メンバーへの特定のNavigationWindowアクセスが必要な場合は、値をMainWindowキャストするNavigationWindow必要NavigationWindowがあります。

このプロパティは、オブジェクトを作成 Application したスレッドからのみ使用できます。

適用対象

こちらもご覧ください