Bagikan melalui


ApplicationView Kelas

Definisi

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

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

Lihat juga