Bagikan melalui

Jenis Kontrol SemanticZoom

  • Artikel

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

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
  • Daftar
    • [SemanticZoom]
      • ListItem (0 atau lebih)
  • Daftar
    • ListItem (0 atau lebih)

Atau:

Tampilan Kontrol Tampilan Konten
  • [SemanticZoom]
    • Daftar
      • ListItem (0 atau lebih)
  • Daftar
    • ListItem (0 atau lebih)

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 .)

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation