Application.MainWindow Özellik

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Uygulamanın ana penceresini alır veya ayarlar.

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

Özellik Değeri

Window

Window Ana uygulama penceresi olarak belirlenen bir.

Özel durumlar

InvalidOperationException

MainWindow , XAML tarayıcı uygulamaları (XBAP'ler) gibi bir tarayıcıda barındırılan bir uygulamadan ayarlanır.

Örnekler

Aşağıdaki örnekte ana uygulama penceresinin nasıl bulunu olduğu gösterilmektedir.

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

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

Aşağıdaki örnekte XAML kullanılarak nasıl ayarlanacağı MainWindow gösterilmektedir.

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

Aşağıdaki örnekte, uygulama başlatma sırasında kodda örneği oluşturma MainWindow işlemi gösterilmektedir.

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

Açıklamalar

MainWindow, içinde örneği AppDomainoluşturulacak ilk Window nesneye başvuruyla otomatik olarak ayarlanır.

Özelliğe başka bir nesne MainWindow atayarak MainWindow farklı bir Windows ana pencere belirtebilirsiniz.

nesnesinin ShutdownMode Application özelliği olarak OnMainWindowCloseayarlanırsa, ana pencerenin kapatılması uygulamanın kapanmasına neden olur.

Bir uygulamanın ana penceresi, özelliği XAML'de ayarlanarak oluşturulan pencere değilse, özelliği XAML'den ayarlamak MainWindow StartupUri mümkündür. XAML yaklaşımının iki sınırlaması şunlardır:

• Ana pencere olarak yalnızca Window XAML veya yalnızca NavigationWindow XAML belirtebilirsiniz.

• Belirttiğiniz pencerenin özelliğini ayarlamanız Visibility gerekir, aksi takdirde gösterilmez.

Örneği oluşturulacak ilk Window nesneye başvuru da koleksiyona Windows ilk öğe olarak eklenir. Daha sonra farklı Windowbir öğesine başvuruyla ayarlanırsaMainWindow, içindeki öğelerin sırası aynı kalırken, ana pencere başvurusuna sahip öğenin Windows konumu değişir. Sonuç olarak, her zaman içindeki ilk öğe Windowsyerine ana pencereye başvurmak için kullanınMainWindow.

Not

Ana pencere bir NavigationWindowise ve üyelere belirli bir erişime NavigationWindow ihtiyacınız varsa değerini olarak atamanız MainWindow NavigationWindowgerekir.

Bu özellik yalnızca nesneyi oluşturan iş parçacığından Application kullanılabilir.

Ayrıca bkz.

• Exit