Window Kelas

Referensi

Definisi

Ruang nama:: Microsoft.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 saat ini.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window

Public Class Window

Warisan: Object IInspectable Window

Atribut: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

OnLaunched

Contoh kode berikut menunjukkan penimpaan metode OnLaunched yang dihasilkan untuk WinUI di templat Desktop di Microsoft Visual Studio. Kode ini menunjukkan penggunaan umum metode Aktifkan pada Window.

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

Buat Jendela baru

Di aplikasi, Anda dapat membuat setiap Jendela secara eksplisit. Membuat lebih dari satu Jendela memerlukan pembaruan 1.0.1 ke WindowsAppSDK, dan terbatas pada satu utas.

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

Anda juga dapat menentukan Jendela baru dalam markup:

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

dengan kode yang sesuai di belakang:

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
var window = new MainWindow();
window.Activate();

Keterangan

Anda dapat membuat lebih dari satu Window per utas di aplikasi Anda. Lihat Membuat Jendela baru di Contoh.

Window mengimplementasikan IWindowNative untuk mengaktifkan interop melalui Window's HWND (WindowHandle).

Biasanya, Window digunakan untuk mengatur UIElement ke Konten yang mewakili UI aplikasi. Ini biasanya dilakukan sebagai bagian dari aktivasi aplikasi (misalnya dalam penimpaan OnLaunched ) dan memungkinkan Anda untuk mengubah konten jendela sepanjang masa pakai jendela.

Pastikan Anda memanggil Aktifkan pada apa pun yang Window digunakan pada aktivasi awal. Jika Anda menggunakan templat aplikasi default dari Microsoft Visual Studio, Window.Activate disertakan dalam file app.xaml code-behind.

Konstruktor

Window()

Menginisialisasi instans baru kelas Jendela .

Properti

AppWindow	Mendapatkan yang `AppWindow` terkait dengan XAML `Window`ini.
Bounds	Mendapatkan nilai Rect yang berisi tinggi dan lebar jendela aplikasi dalam satuan piksel efektif (tampilan).
Compositor	Mendapatkan Compositor untuk jendela ini.
Content	Mendapatkan atau mengatur akar visual jendela aplikasi.
CoreWindow	Aplikasi desktop selalu kembali `null` untuk properti ini.
Current	Aplikasi desktop selalu kembali `null` untuk properti ini.
Dispatcher	Selalu kembali `null` di aplikasi SDK Aplikasi Windows. Catatan `Window.Dispatcher` dapat diubah atau tidak tersedia dalam rilis mendatang. Gunakan Window.DispatcherQueue sebagai gantinya.
DispatcherQueue	`DispatcherQueue` Mendapatkan objek untuk jendela.
ExtendsContentIntoTitleBar	Mendapatkan atau menetapkan nilai yang menentukan apakah bilah judul default jendela harus disembunyikan untuk membuat ruang untuk konten aplikasi.
SystemBackdrop	Mendapatkan atau mengatur latar belakang sistem untuk diterapkan ke ini `Window`. Latar belakang dirender di `Window` belakang konten.
Title	Mendapatkan atau mengatur string yang digunakan untuk judul 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)	Mengaktifkan perilaku bilah judul pada elemen XAML saat `ExtendsContentIntoTitleBar` adalah `true`.

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

Bagikan melalui