Window Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Mendapatkan 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