ApplicationView Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.ViewManagement

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 tampilan aplikasi aktif dan status dan perilaku terkait.

public ref class ApplicationView 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 ApplicationView 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 ApplicationView

Public NotInheritable Class ApplicationView

Warisan: Object Platform::Object IInspectable ApplicationView

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)

Keterangan

Jendela (juga disebut tampilan aplikasi) adalah bagian yang ditampilkan dari aplikasi Windows Runtime. Di Windows, layar pengguna dapat memiliki hingga 4 jendela lebar variabel yang ditampilkan secara bersamaan. Mereka tidak tumpang tindih, dan tepi atas dan bawahnya menyentuh tepi atas dan bawah layar. Mungkin ada area non-jendela antara jendela yang berdekatan.

Jendela tidak sama dengan halaman aplikasi saat ini. Lebih baik dianggap sebagai wadah halaman; Anda dapat menggunakan referensi jendela dalam program Anda untuk semua halaman aplikasi.

Setiap jendela memiliki CoreWindow yang sesuai yang mewakili utas pemrosesan UI (termasuk penangan input inti dan dispatcher peristiwa) untuk jendela.

Anda dapat menggunakan properti (atau metode, untuk JavaScript) jendela dalam mengonfigurasi halaman Anda. Misalnya: properti Orientasi memberi tahu Anda apakah jendela adalah potret atau lanskap; untuk Windows properti AdjacentToLeftDisplayEdge memberi tahu Anda apakah tepi kiri layar adalah batas kiri jendela; dan metode isFullScreen memberi tahu Anda apakah jendela menggunakan seluruh layar. Untuk contoh penggunaan metode ini, lihat sampel Tampilan Aplikasi .

Untuk mendapatkan objek jenis ini, panggil ApplicationView.GetForCurrentView.

Catatan

Jangan gunakan nilai yang dikembalikan di properti ApplicationView.Value saat membuat tata letak halaman. Metode ini tidak digunakan lagi dan mungkin tidak tersedia dalam rilis mendatang.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	IsViewModeSupported
1703	15063	TryConsolidateAsync
1703	15063	TryEnterViewModeAsync(ApplicationViewMode)
1703	15063	TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
1703	15063	ViewMode
1903	18362	ClearAllPersistedState
1903	18362	ClearPersistedState
1903	18362	GetDisplayRegions
1903	18362	PersistedStateId
1903	18362	UIContext
1903	18362	WindowingEnvironment

Properti

AdjacentToLeftDisplayEdge	Mendapatkan nilai yang menunjukkan apakah jendela saat ini berada di dekat tepi kiri layar.
AdjacentToRightDisplayEdge	Mendapatkan nilai yang menunjukkan apakah jendela saat ini berada di dekat tepi kanan layar.
DesiredBoundsMode	Mendapatkan nilai yang menunjukkan batas yang digunakan oleh kerangka kerja untuk menjabarkan konten jendela (tampilan aplikasi).
FullScreenSystemOverlayMode	Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana aplikasi dalam mode layar penuh merespons tindakan gesek tepi.
Id	Mendapatkan ID jendela (tampilan aplikasi).
IsFullScreen	Catatan IsFullScreen dapat diubah atau tidak tersedia untuk rilis setelah Windows 10. Sebagai gantinya, gunakan IsFullScreenMode. Mendapatkan nilai yang menunjukkan apakah jendela menyentuh sisi kiri dan kanan tampilan.
IsFullScreenMode	Mendapatkan nilai yang menunjukkan apakah aplikasi berjalan dalam mode layar penuh.
IsOnLockScreen	Mendapatkan apakah jendela (tampilan aplikasi) ada di layar kunci Windows.
IsScreenCaptureEnabled	Mendapatkan atau mengatur apakah tangkapan layar diaktifkan untuk jendela (tampilan aplikasi).
Orientation	Mendapatkan orientasi saat ini (lanskap atau potret) jendela (tampilan aplikasi) sehubungan dengan tampilan.
PersistedStateId	Mendapatkan atau mengatur string yang mengidentifikasi tampilan ini untuk melacak dan menyimpan status.
PreferredLaunchViewSize	Mendapatkan atau mengatur ukuran yang diluncurkan aplikasi saat properti ApplicationView.PreferredLaunchWindowingMode diatur ke PreferredLaunchViewSize, kecuali jika sistem mengelola ukuran jendela secara langsung.
PreferredLaunchWindowingMode	Mendapatkan atau menetapkan nilai yang menunjukkan mode windowing yang diluncurkan aplikasi.
SuppressSystemOverlays	Catatan SuppressSystemOverlays dapat diubah atau tidak tersedia untuk rilis setelah Windows 10. Sebagai gantinya, gunakan TryEnterFullScreenMode dan FullScreenSystemOverlayMode. Mendapatkan atau menetapkan nilai yang menunjukkan apakah overlay sistem (seperti aplikasi overlay atau roda kemudi lunak) harus ditampilkan atau tidak.
TerminateAppOnFinalViewClose	Menunjukkan apakah aplikasi berakhir saat jendela terakhir ditutup.
Title	Mendapatkan atau mengatur judul jendela yang ditampilkan.
TitleBar	Mendapatkan bilah judul aplikasi.
UIContext	Mendapatkan pengidentifikasi konteks untuk tampilan.
Value	Catatan Metode statis ApplicationView dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan ApplicationView.GetForCurrentView untuk mendapatkan objek ApplicationView . Mendapatkan status jendela saat ini (tampilan aplikasi).
ViewMode	Mendapatkan mode tampilan aplikasi untuk tampilan saat ini.
VisibleBounds	Mendapatkan wilayah jendela yang terlihat (tampilan aplikasi). Wilayah yang terlihat adalah wilayah yang tidak terpakai oleh chrome seperti bilah status dan bilah aplikasi.
WindowingEnvironment	Mendapatkan lingkungan windowing untuk tampilan.

Metode

ClearAllPersistedState()	Menghapus properti apa pun yang telah disimpan sistem untuk setiap tampilan PersistedStateId untuk aplikasi yang diberikan.
ClearPersistedState(String)	Menghapus properti apa pun yang telah disimpan sistem untuk tampilan dengan pengidentifikasi yang ditentukan untuk aplikasi yang diberikan.
ExitFullScreenMode()	Keluarkan aplikasi dari mode layar penuh.
GetApplicationViewIdForWindow(ICoreWindow)	Mendapatkan ID jendela yang sesuai dengan CoreWindow tertentu yang dikelola oleh aplikasi.
GetDisplayRegions()	Mengembalikan kumpulan wilayah tampilan yang tersedia untuk tampilan.
GetForCurrentView()	Mendapatkan status tampilan dan pengaturan perilaku aplikasi aktif.
IsViewModeSupported(ApplicationViewMode)	Menentukan apakah mode tampilan yang ditentukan didukung pada perangkat saat ini.
SetDesiredBoundsMode(ApplicationViewBoundsMode)	Mengatur nilai yang menunjukkan batas yang digunakan oleh kerangka kerja untuk meletakkan konten jendela (tampilan aplikasi).
SetPreferredMinSize(Size)	Mengatur ukuran terkecil, dalam piksel efektif, yang diizinkan untuk jendela aplikasi.
ShowStandardSystemOverlays()	Menampilkan elemen antarmuka pengguna sistem, seperti bilah judul, melalui aplikasi layar penuh.
TryConsolidateAsync()	Mencoba menyembunyikan tampilan aplikasi saat ini. Metode ini setara dengan pengguna yang menutup aplikasi.
TryEnterFullScreenMode()	Mencoba menempatkan aplikasi dalam mode layar penuh.
TryEnterViewModeAsync(ApplicationViewMode)	Mencoba mengubah tampilan aplikasi ke mode tampilan yang ditentukan.
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	Mencoba mengubah tampilan aplikasi ke mode tampilan yang ditentukan menggunakan opsi yang ditentukan.
TryResizeView(Size)	Mencoba mengubah ukuran tampilan ke ukuran yang ditentukan dalam piksel yang efektif.
TryUnsnap()	Catatan TryUnsnap dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Aplikasi dapat terus diubah ukurannya, tetapi tidak dapat diposisikan, mulai dari Windows 8.1. Selain itu, metode statis ApplicationView dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Gunakan ApplicationView.GetForCurrentView untuk mendapatkan objek ApplicationView . Mencoba untuk membatalkan penggantian aplikasi yang sebelumnya di-snap. Panggilan ini hanya akan berhasil ketika aplikasi berjalan di latar depan.
TryUnsnapToFullscreen()	Mencoba untuk membatalkan penggantian aplikasi yang sebelumnya di-snap.

Acara

Consolidated	Terjadi ketika jendela dihapus dari daftar aplikasi yang baru digunakan, atau jika pengguna menjalankan gerakan dekat di atasnya.
VisibleBoundsChanged	Kejadian ini dinaikkan saat nilai VisibleBounds berubah, biasanya sebagai hasil dari bilah status, bilah aplikasi, atau chrome lain yang ditampilkan atau disembunyikan.

Berlaku untuk