Jenis Kontrol SemanticZoom
Topik ini menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol SemanticZoom .
Semantic Zoom adalah teknik yang diperkenalkan di Windows 8 untuk menyajikan dan menavigasi kumpulan besar data atau konten terkait dalam satu tampilan, seperti album foto, daftar aplikasi, atau buku alamat. Zoom Semantik menggunakan dua mode klasifikasi yang berbeda, atau tingkat zoom, untuk mengatur dan menyajikan konten. Mode tingkat rendah (atau diperbesar) menampilkan item dalam struktur "all-up" datar; dan mode tingkat tinggi (atau diperkecil) menampilkan item dalam grup, memungkinkan pengguna untuk menavigasi dan menelusuri konten dengan cepat. Misalnya, memperbesar daftar kota mungkin berubah menjadi daftar status yang berisi kota-kota tersebut. Memperbesar daftar program mungkin berubah menjadi daftar grup program logis.
Untuk informasi selengkapnya tentang Semantic Zoom khususnya seperti yang digunakan untuk aplikasi Windows Store, lihat Panduan untuk Zoom Semantik.
Model penggunaan untuk jenis kontrol SemanticZoom tidak biasa karena ada terutama untuk akses terprogram. Klien Microsoft UI Automation dapat memantau dan memanipulasi kontrol Zoom Semantik untuk mengontrol status daftar yang diperbesar. Pengguna yang tidak menggunakan teknologi bantu biasanya akan memanipulasi kontrol Zoom Semantik secara langsung melalui gerakan sentuh atau pintasan keyboard.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol SemanticZoom . Persyaratan Otomatisasi UI berlaku untuk semua kontrol Zoom Semantik tempat kerangka kerja/platform UI mengintegrasikan dukungan Otomatisasi UI untuk jenis kontrol dan pola kontrol.
Topik ini berisi bagian berikut.
- Struktur Pohon Umum
- Properti yang Relevan
- Pola dan Properti Kontrol yang Diperlukan
- Peristiwa yang Diperlukan
- Keterangan
- Topik terkait
Struktur Pohon Umum
Tabel berikut menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan jenis kontrol SemanticZoom dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
Tampilan Kontrol | Tampilan Konten |
---|---|
|
|
Atau:
Tampilan Kontrol | Tampilan Konten |
---|---|
|
|
Properti yang Relevan
Tabel berikut mencantumkan properti Automasi UI yang nilai atau definisinya sangat relevan dengan kontrol yang mengimplementasikan jenis kontrol SemanticZoom . Untuk informasi selengkapnya tentang properti Otomatisasi UI, lihat Mengambil Properti dari Elemen Automasi UI.
Properti UI Automation | Nilai | Catatan |
---|---|---|
UIA_AutomationIdPropertyId | Lihat catatan. | Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI. |
UIA_BoundingRectanglePropertyId | Lihat catatan. | Persegi panjang terluar yang berisi seluruh kontrol. |
UIA_ClickablePointPropertyId | Lihat catatan. | Jika kontrol daftar memiliki titik yang dapat diklik (titik yang dapat diklik untuk menyebabkan daftar mengambil fokus), titik tersebut harus diekspos melalui properti ini. Jika nilai properti UIA_IsOffscreenPropertyIdTRUE, mencoba mengambil properti ini menghasilkan kesalahan UIA_E_NOCLICKABLEPOINT . |
UIA_ControlTypePropertyId | SemantikZoom | |
UIA_IsContentElementPropertyId | TRUE | |
UIA_IsControlElementPropertyId | TRUE | |
UIA_IsKeyboardFocusablePropertyId | FALSE | |
UIA_LabeledByPropertyId | Lihat catatan. | Jika ada label teks statis, properti ini harus mengekspos referensi ke kontrol tersebut. |
UIA_LocalizedControlTypePropertyId | Lihat catatan. | String yang dilokalkan sesuai dengan jenis kontrol SemanticZoom . Nilai defaultnya adalah "zoom semantik" untuk en-US atau English (Amerika Serikat).
Catatan: Beberapa kerangka kerja menggabungkan ini sebagai "semantikzoom". |
UIA_NamePropertyId | Lihat catatan. | String kosong dapat diterima, atau nama yang lebih berguna dapat disediakan, selama tidak berisi istilah zoom semantik , yang akan membuat kombinasi jenis kontrol dan nama membingungkan. |
Pola dan Properti Kontrol yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automasi UI yang diperlukan untuk didukung oleh semua kontrol Zoom Semantik. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
---|---|---|
IToggleProvider | Bergantung | Kontrol Zoom Semantik mendukung pola kontrol Alihkan untuk memungkinkan zoom diaktifkan atau dinonaktifkan. ToggleState_Off sesuai dengan flat, status all-up, dan ToggleState_On sesuai dengan tampilan tingkat tinggi yang diperkecil. |
Peristiwa yang Diperlukan
Tabel berikut mencantumkan peristiwa Automation UI yang diperlukan kontrol Zoom Semantik untuk mendukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
Peristiwa UI Automation | Catatan |
---|---|
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti. | |
UIA_IsEnabledPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsEnabled , kontrol harus mendukung kejadian ini. |
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung kejadian ini. |
UIA_ToggleToggleStatePropertyId peristiwa yang diubah properti. |
Keterangan
Jika UI memiliki tombol yang terlihat untuk mengalihkan perilaku kontrol Semantic Zoom, tombol ini seharusnya tidak memiliki jenis kontrol SemanticZoom . Ini bersifat kontra-intuitif, tetapi jenis kontrol SemanticZoom mencirikan kontainer konten zooming, bukan tombol yang mengontrol zoom. (Tombol seperti itu dapat direpresentasikan hanya sebagai jenis kontrol Tombol dengan pola kontrol Hidupkan/Matikan .)