Application.MainWindow Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur jendela utama aplikasi.

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

Nilai Properti

Window

Window Yang ditetapkan sebagai jendela aplikasi utama.

Pengecualian

InvalidOperationException

MainWindow diatur dari aplikasi yang dihosting di browser, seperti aplikasi browser XAML (XBAP).

Contoh

Contoh berikut menunjukkan cara menemukan jendela aplikasi utama.

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

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

Contoh berikut menunjukkan cara mengatur MainWindow menggunakan XAML.

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

Contoh berikut menunjukkan cara membuat instans MainWindow dalam kode selama pengaktifan aplikasi.

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

Keterangan

MainWindow secara otomatis diatur dengan referensi ke objek pertama Window yang akan dibuat di AppDomain.

Anda dapat menentukan jendela utama yang berbeda dengan mengatur MainWindow penetapan objek lain Windows ke MainWindow properti .

ShutdownMode Jika properti Application objek diatur ke OnMainWindowClose, menutup jendela utama menyebabkan aplikasi dimatikan.

Dimungkinkan MainWindow untuk mengatur properti dari XAML, jika jendela utama aplikasi bukan jendela yang diproduksi dengan mengatur StartupUri properti di XAML. Dua batasan pendekatan XAML adalah:

• Anda dapat menentukan hanya XAML Window atau XAML-only NavigationWindow sebagai jendela utama.

• Anda harus mengatur Visibility properti jendela yang Anda tentukan, jika tidak, properti tidak akan ditampilkan.

Referensi ke objek pertama Window yang akan dibuat instans juga ditambahkan sebagai item pertama ke Windows koleksi. Jika MainWindow kemudian diatur dengan referensi ke yang berbeda Window, posisi item dengan referensi ke jendela utama akan berubah, sementara urutan item di Windows tetap sama. Akibatnya, selalu gunakan MainWindow untuk merujuk ke jendela utama alih-alih item pertama di Windows.

Nota

Jika jendela utama adalah NavigationWindow, dan Anda memerlukan akses khusus ke NavigationWindow anggota, Anda harus melemparkan nilai MainWindow ke NavigationWindow.

Properti ini hanya tersedia dari utas yang membuat Application objek.

Lihat juga

• Exit