Bagikan melalui


Window Kelas

Definisi

Mewakili jendela aplikasi.

public ref class Window sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Window
Public NotInheritable Class Window
Warisan
Object Platform::Object IInspectable Window
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh kode berikut menunjukkan penimpaan metode OnLaunched yang dihasilkan untuk templat aplikasi kosong di Microsoft Visual Studio. Kode ini menunjukkan pola penggunaan umum untuk properti Saat Ini dan Konten dan metode Aktifkan .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}
Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Keterangan

Kelas ini mewakili jendela Aplikasi saat ini. Dengan cara yang sama seperti properti Aplikasi statis, properti Current statis akan mengembalikan objek jendela aplikasi. Dari objek ini, aplikasi dapat menggunakan Dispatcher atau menentukan ukuran Jendela dari properti Batas . Penggunaan yang paling umum untuk Window adalah mengatur UIElement ke Konten yang mewakili UI aplikasi. Ini biasanya dilakukan sebagai bagian dari aktivasi aplikasi (misalnya dalam penimpaan OnLaunched .) Anda dapat mengubah konten jendela ini sepanjang masa pakai jendela.

Tidak ada representasi XAML dari kelas Jendela karena bukan kontrol.

Objek Window hanya memunculkan informasi dari CoreWindow, yang pada gilirannya mereferensikan jendela yang dibuat oleh sistem.

Pastikan untuk memanggil Aktifkan pada Jendela apa pun yang Anda gunakan pada aktivasi awal. Jika Anda menggunakan templat aplikasi default dari Microsoft Visual Studio, memanggil Window.Activate adalah bagian dari kode awal dalam file app.xaml code-behind.

Kelas LayoutAwarePage yang merupakan bagian dari beberapa templat aplikasi di Microsoft Visual Studio memiliki penanganan untuk peristiwa SizeChanged , yang digunakan untuk melacak status visual yang cocok dengan nilai ApplicationViewState. LayoutAwarePage juga memiliki kode yang memeriksa Batas dan menggunakan nilai ini untuk memengaruhi cara peristiwa input di seluruh halaman ditangani.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1703 15063 Komposit
1903 18362 UIContext

Anggota antarmuka tambahan

IXamlSourceTransparency.IsBackgroundTransparentMendapatkan atau menetapkan nilai yang menentukan apakah latar belakang semua objek DesktopWindowXamlSource pada utas saat ini transparan.

Properti

Bounds

Mendapatkan nilai Rect yang berisi asal, tinggi, dan lebar area klien jendela, dalam piksel independen perangkat (DIP).

Compositor

Mendapatkan Compositor untuk jendela ini.

Content

Mendapatkan atau mengatur akar visual jendela aplikasi.

CoreWindow

Mendapatkan objek inti internal untuk jendela aplikasi.

Current

Mendapatkan jendela utas saat ini.

Dispatcher

Mendapatkan objek CoreDispatcher untuk Jendela, yang umumnya merupakan CoreDispatcher untuk utas UI.

UIContext

Mendapatkan pengidentifikasi konteks untuk jendela.

Visible

Mendapatkan nilai yang melaporkan apakah jendela terlihat.

Metode

Activate()

Mencoba mengaktifkan jendela aplikasi dengan membawanya ke latar depan dan mengatur fokus input ke jendela tersebut.

Close()

Menutup jendela aplikasi.

SetTitleBar(UIElement)

Membuat elemen XAML berinteraksi dengan sistem seolah-olah itu adalah bilah judul.

Acara

Activated

Terjadi ketika jendela berhasil diaktifkan.

Closed

Terjadi ketika jendela telah ditutup.

SizeChanged

Terjadi saat jendela aplikasi pertama kali dirender atau telah mengubah ukuran penyajiannya.

VisibilityChanged

Terjadi ketika nilai properti Terlihat berubah.

Berlaku untuk

Lihat juga