Application.MainWindow プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーションのメイン ウィンドウを取得または設定します。
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。
例外
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 したスレッドからのみ使用できます。