AppWindow Kelas

Definisi

Ruang nama:

Windows.UI.WindowManagement

Mewakili kontainer yang dikelola sistem untuk konten aplikasi.

public ref class AppWindow sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [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(Windows.Foundation.UniversalApiContract), 524288)]
[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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1903 (diperkenalkan dalam 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v8.0)

Keterangan

Catatan

AppWindow saat ini dalam pratinjau. Ini berarti Anda dapat mengirimkan aplikasi yang menggunakan AppWindow ke Store, tetapi beberapa platform dan komponen kerangka kerja diketahui tidak berfungsi dengan AppWindow (lihat Batasan).

AppWindow dapat digunakan untuk mewakili bagian yang ditampilkan dari aplikasi Windows Runtime saat memiliki lebih dari satu jendela. Ini mirip dalam konsep dengan ApplicationView, tetapi tidak sama dalam perilaku dan masa pakai.

Tidak seperti ApplicationView, setiap AppWindow tidak memiliki CoreWindow yang sesuai. Semuanya berbagi utas pemrosesan UI yang sama (termasuk dispatcher peristiwa) tempat mereka dibuat.

Untuk mendapatkan objek jenis ini, panggil AppWindow.TryCreateAsync.

Untuk menyambungkan konten ke AppWindow Anda, panggil ElementCompositionPreview.SetAppWindowContent.

Anda hanya dapat menyambungkan konten XAML ke AppWindow Anda, tidak ada dukungan untuk konten DirectX atau Holografik asli.

Untuk menentukan ukuran minimum pilihan untuk jendela aplikasi, gunakan metode WindowManagementPreview.SetPreferredMinSize .

Tip

Untuk informasi dan kode selengkapnya yang menunjukkan AppWindow, lihat Menampilkan beberapa tampilan untuk aplikasi dan Menampilkan beberapa tampilan dengan AppWindow.

Sampel yang menunjukkan cara menggunakan Api AppWindow dapat ditemukan di repositori Sampel Universal Windows di GitHub di bawah Sampel/AppWindow.

Batasan

Batasan dalam versi pratinjau AppWindow saat ini termasuk (ini adalah daftar yang tidak lengkap):

• API apa pun yang menggunakan pola GetForCurrentView tidak berfungsi untuk AppWindow karena CurrentView mengacu pada ApplicationView yang merupakan entitas terpisah dari AppWindow.
• Pemutaran media layar penuh tidak tersedia di MediaElement atau MediaPlayerElement.
• MessageDialog tidak akan dimodifikasi ke jendela yang benar, rekomendasinya adalah menggunakan ContentDialog sebagai gantinya.
• WebView tidak sepenuhnya didukung. Anda dapat menggunakan WebView in-proc, tetapi apa pun di luar konten HTML statis mungkin atau mungkin tidak berfungsi dengan baik.
• Jika Anda mengatur properti Window.Current.Content di XAML, properti tersebut akan menghancurkan semua konten XAML di AppWindow Anda. Hindari menggunakan ini sebagai pola untuk mengatur ulang konten saat menangguhkan aplikasi jika Anda menggunakan AppWindow.
• Mengubah Ukuran Jendela Halus tidak berfungsi untuk AppWindows. Bingkai dan konten akan mengubah ukuran secara independen, yang dapat terlihat tidak terpolakan ketika tata letak konten lambat.
• DisplayInformation tidak dapat diakses untuk AppWindow. Jika AppWindow Anda berada di monitor yang berbeda dari ApplicationView Anda, Anda tidak akan dapat mengkueri informasi tampilan yang benar.
• UserInteractionMode tidak dapat diatur untuk AppWindow.
• Dialog cetak (2D dan 3D) tidak akan diindukkan ke jendela yang benar.
• AppWindow tidak dapat mendeteksi kapan gerakan tepi sedang dipanggil.
• AppWindow tidak dapat digunakan untuk memenuhi permintaan aktivasi melalui ActivationViewSwitcher.

Properti

Content	Mendapatkan konten aplikasi yang saat ini dilampirkan ke jendela.
DispatcherQueue	Mendapatkan antrean dispatcher untuk jendela aplikasi.
Frame	Mendapatkan bingkai untuk jendela aplikasi.
IsVisible	Mendapatkan nilai yang menunjukkan apakah jendela dapat dilihat pada tampilan.
PersistedStateId	Mendapatkan atau mengatur string yang mengidentifikasi jendela ini untuk melacak dan menyimpan status.
Presenter	Mendapatkan penyaji untuk jendela aplikasi.
Title	Mendapatkan atau mengatur judul jendela aplikasi yang ditampilkan.
TitleBar	Mendapatkan bilah judul jendela aplikasi.
UIContext	Mendapatkan konteks UI untuk jendela aplikasi.
WindowingEnvironment	Mendapatkan lingkungan windowing untuk jendela aplikasi.

Metode

ClearAllPersistedState()	Menghapus properti apa pun yang telah disimpan sistem untuk setiap jendela PersistedStateId untuk aplikasi yang diberikan.
ClearPersistedState(String)	Menghapus properti apa pun yang telah disimpan sistem untuk jendela dengan ID yang ditentukan untuk aplikasi yang diberikan.
CloseAsync()	Menutup jendela aplikasi.
GetDisplayRegions()	Mengembalikan kumpulan wilayah tampilan yang tersedia untuk jendela aplikasi.
GetPlacement()	Mengembalikan objek penempatan yang menjelaskan wilayah tampilan, offset, dan ukuran jendela aplikasi.
RequestMoveAdjacentToCurrentView()	Membuat permintaan untuk memposisikan jendela di samping tampilan saat ini.
RequestMoveAdjacentToWindow(AppWindow)	Membuat permintaan untuk memosisikan jendela di samping jendela jangkar yang ditentukan.
RequestMoveRelativeToCurrentViewContent(Point)	Membuat permintaan untuk memosisikan jendela pada offset yang ditentukan relatif terhadap tampilan saat ini.
RequestMoveRelativeToDisplayRegion(DisplayRegion, Point)	Membuat permintaan untuk memosisikan jendela di wilayah tampilan yang ditentukan pada offset yang ditentukan.
RequestMoveRelativeToWindowContent(AppWindow, Point)	Membuat permintaan untuk memosisikan jendela pada offset yang ditentukan relatif terhadap jendela jangkar.
RequestMoveToDisplayRegion(DisplayRegion)	Membuat permintaan untuk memosisikan jendela di wilayah tampilan yang ditentukan.
RequestSize(Size)	Membuat permintaan untuk mengatur jendela ke ukuran yang ditentukan.
TryCreateAsync()	Mencoba membuat instans baru AppWindow secara asinkron.
TryShowAsync()	Upaya untuk menampilkan jendela aplikasi saat ini secara asinkron.

Acara

Changed	Terjadi ketika properti jendela aplikasi telah berubah.
Closed	Terjadi ketika jendela aplikasi telah ditutup.
CloseRequested	Terjadi setelah jendela mulai ditutup, tetapi sebelum ditutup dan sebelum peristiwa Ditutup terjadi.