Bagikan melalui


AppWindow Kelas

Definisi

Mewakili kontainer yang dikelola sistem untuk konten aplikasi.

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

Keterangan

Penting

API penyesuaian bilah judul didukung sebagian pada Windows 10 sejak SDK Aplikasi Windows 1.2 dan didukung penuh pada Windows 11. Anda harus memeriksa AppWindowTitleBar.IsCustomizationSupported dalam kode Anda sebelum memanggil API ini untuk memastikan aplikasi Anda tidak mengalami crash pada versi Windows lainnya. Lihat Kustomisasi bilah judul untuk informasi selengkapnya.

Properti

ClientSize

Mendapatkan ukuran area klien jendela saat ini di koordinat klien Win32.

DispatcherQueue

Mendapatkan antrean dispatcher yang terkait dengan jendela aplikasi.

Id

Mendapatkan pengidentifikasi untuk jendela aplikasi.

IsShownInSwitchers

Mendapatkan atau menetapkan nilai yang menunjukkan apakah jendela ini akan muncul di berbagai representasi sistem, seperti ALT+TAB dan taskbar.

IsVisible

Mendapatkan nilai yang menunjukkan apakah jendela ditampilkan.

OwnerWindowId

Mendapatkan pengidentifikasi pemilik jendela ini; atau 0 jika tidak dimiliki.

Position

Mendapatkan posisi jendela saat ini dalam koordinat layar.

Presenter

Mendapatkan penyaji yang saat ini diterapkan untuk jendela aplikasi.

Size

Mendapatkan ukuran jendela saat ini dalam koordinat layar.

Title

Mendapatkan atau mengatur judul jendela aplikasi yang ditampilkan.

TitleBar

Mendapatkan bilah judul jendela aplikasi.

Metode

AssociateWithDispatcherQueue(DispatcherQueue)

Mengaitkan jendela aplikasi dengan antrean dispatcher yang ditentukan.

Create()

Membuat jendela aplikasi dengan gaya dan properti yang diatur ke default OverlappedPresenter.

Create(AppWindowPresenter)

Membuat jendela dengan gaya dan properti seperti yang ditentukan dalam yang ditentukan AppWindowPresenter.

Create(AppWindowPresenter, WindowId)

Membuat jendela dengan gaya dan properti seperti yang ditentukan dalam yang ditentukan AppWindowPresenter dan diindukkan ke jendela yang ditentukan.

Create(AppWindowPresenter, WindowId, DispatcherQueue)

Membuat jendela dengan gaya dan properti seperti yang ditentukan dalam yang ditentukan AppWindowPresenter, diindukkan ke jendela yang ditentukan, dan terkait dengan yang ditentukan DispatcherQueue.

Destroy()

Upaya untuk menghancurkan jendela aplikasi.

GetFromWindowId(WindowId)

Mengembalikan AppWindow dengan yang ditentukan WindowId, jika tersedia. Mengembalikan null jika WindowId tidak dapat dicocokkan dengan jendela yang valid.

Hide()

Menyembunyikan jendela dari semua representasi UX dalam sistem tetapi menjaga objek tetap hidup.

Move(PointInt32)

Memindahkan jendela ke titik yang ditentukan dalam koordinat layar.

MoveAndResize(RectInt32)

Memindahkan jendela ke titik yang ditentukan dalam koordinat layar dan mengaturnya ke ukuran yang ditentukan.

MoveAndResize(RectInt32, DisplayArea)

Memindahkan jendela ke titik yang ditentukan dalam area tampilan yang diberikan dan mengaturnya ke ukuran yang ditentukan.

MoveInZOrderAtBottom()

Memindahkan jendela saat ini menjadi jendela bawah dalam urutan Z.

MoveInZOrderAtTop()

Memindahkan jendela saat ini menjadi jendela atas dalam urutan Z.

MoveInZOrderBelow(WindowId)

Memindahkan jendela saat ini ke bawah jendela yang ditentukan dalam urutan Z.

Resize(SizeInt32)

Mengubah ukuran jendela ke ukuran yang ditentukan.

ResizeClient(SizeInt32)

Mengubah ukuran jendela untuk mengakomodasi ukuran yang ditentukan untuk area klien.

SetIcon(IconId)

Mengatur ikon untuk jendela, menggunakan ID ikon yang ditentukan.

SetIcon(String)

Mengatur ikon untuk jendela, menggunakan jalur ikon yang ditentukan.

SetPresenter(AppWindowPresenter)

Menerapkan penyaji yang ditentukan ke jendela.

SetPresenter(AppWindowPresenterKind)

Menerapkan jenis penyaji yang ditentukan ke jendela.

Show()

Menampilkan jendela dan mengaktifkannya.

Show(Boolean)

Memperlihatkan jendela dengan opsi untuk mengaktifkannya atau tidak.

ShowOnceWithRequestedStartupState()

Memperlihatkan jendela dengan penyaji default dalam status yang diminta.

Acara

Changed

Terjadi ketika properti jendela telah berubah, dan sistem berada dalam "keadaan stabil" untuk saat ini.

Closing

Terjadi ketika jendela sedang ditutup melalui keterjanjakan sistem.

Destroying

Terjadi ketika jendela sedang dihancurkan.

Berlaku untuk

Lihat juga