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

주 애플리케이션 창으로 지정된 A Window 입니다.

예외

InvalidOperationException

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에서 속성을 설정할 MainWindowStartupUri 수 있습니다. XAML 접근 방식의 두 가지 제한 사항은 다음과 같습니다.

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

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

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

메모

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

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

추가 정보

• Exit