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 은 XBAP(XAML 브라우저 애플리케이션)와 같이 브라우저에서 호스트되는 애플리케이션에서 설정됩니다.

예제

다음 예제에서는 기본 애플리케이션 창을 찾는 방법을 보여 줍니다.

// 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 접근 방식의 두 가지 제한 사항은 다음과 같습니다.

  • XAML 전용 또는 XAML 전용 Window NavigationWindow 을 주 창으로 지정할 수 있습니다.

  • 지정한 Visibility 창의 속성을 설정해야 합니다. 그렇지 않으면 표시되지 않습니다.

인스턴스화할 첫 번째 Window 개체에 대한 참조도 컬렉션의 첫 번째 항목 Windows 으로 추가됩니다. 이후에 다른 Window항목에 대한 참조로 설정되면 MainWindow 주 창에 대한 참조가 있는 항목의 위치가 변경되고 항목 Windows 의 순서는 동일하게 유지됩니다. 따라서 항상 첫 번째 항목 Windows대신 주 창을 참조하는 데 사용합니다MainWindow.

참고

주 창이이고 NavigationWindow멤버에 NavigationWindow 대한 특정 액세스 권한이 필요한 경우 값을 MainWindow NavigationWindow으로 캐스팅해야 합니다.

이 속성은 개체를 만든 Application 스레드에서만 사용할 수 있습니다.

적용 대상

추가 정보