Application.MainWindow Özellik

Tanım

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 Ana uygulama penceresi olarak belirlenen bir.

Özel durumlar

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ğinin nasıl MainWindow başlat adımları 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

MainWindowiçinde örneği Windowoluşturulacak ilk AppDomain nesneye bir başvuruyla otomatik olarak ayarlanır.

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

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

Bir uygulamanın ana penceresi XAML'de özelliği ayarlanarak oluşturulan pencere değilse, XAML'den özelliğini ayarlamak MainWindowStartupUri 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.

Örneklenecek ilk Window nesneye başvuru da koleksiyona Windows ilk öğe olarak eklenir. Daha sonra farklı MainWindowbir başvuru ile ayarlanırsaWindow, ana pencereye başvuru içeren öğenin konumu değişir ve içindeki Windows öğelerin sırası aynı kalır. Sonuç olarak, her zaman içindeki ilk öğe MainWindowyerine ana pencereye başvurmak için kullanınWindows.

Note

Ana pencere bir NavigationWindowise ve üyelere özel erişime NavigationWindow ihtiyacınız varsa değerini olarak atamanız MainWindowNavigationWindowgerekir.

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

Şunlara uygulanır

Ayrıca bkz.