Bagikan melalui

Tipe Kontrol Jempol

  • Artikel

Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol Thumb.

Kontrol jempol menyediakan fungsionalitas yang memungkinkan kontrol dipindahkan (atau diseret), seperti tombol bilah gulir, atau mengubah ukuran, seperti widget mengubah ukuran jendela. Perhatikan bahwa kontrol jempol tidak menyediakan fungsionalitas seret dan letakkan. Kontrol jempol dapat menerima fokus mouse tetapi tidak fokus keyboard. Pengembang kontrol harus menerapkan kontrol sehingga bertindak dengan tepat (dapat diseret atau diubah ukurannya).

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Thumb. Persyaratan Automasi UI menerapkan semua kontrol jempol di mana kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.

Topik ini berisi bagian berikut.

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol jempol dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI .

Tampilan Kontrol Tampilan Isi
  • Jempol
 (Tidak berlaku)

 

Kontrol jempol tidak pernah muncul dalam tampilan konten karena hanya ada untuk dimanipulasi dengan mouse. Mereka diekspos melalui pola kontrol lain, seperti pola kontrol Scroll, pola kontrol Transformasi, atau pola kontrol RangeValue, didukung pada kontainer kontrol ibu jari.

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol jempol. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.

Properti Automasi UI 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. Titik dalam area klien yang terlihat dari kontrol jempol.
UIA_ControlTypePropertyId Jempol
UIA_IsContentElementPropertyId PALSU Kontrol jempol tidak pernah disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId BENAR Kontrol jempol selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini. Kontrol jempol dapat menerima fokus jika digunakan sebagai objek "gripper" untuk mengukur jendela atau panel. Kontrol jempol di slider atau bilah gulir tidak boleh menerima fokus.
UIA_LabeledByPropertyId NOL Kontrol jempol tidak pernah memiliki label.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol Thumb. Nilai defaultnya adalah "thumb" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId NOL Karena kontrol jempol tidak tersedia dalam tampilan konten pohon Automation UI, kontrol tersebut tidak memerlukan nama.

 

Pola Kontrol yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol jempol. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .

Pola Kontrol Dukung Catatan
ITransformProvider Diperlukan Memungkinkan kontrol jempol dipindahkan pada layar. Karena kontrol jempol biasanya tidak dapat diubah ukurannya atau diputar, pola kontrol Transform terutama mendukung fungsiPindahkan.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol jempol untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsEnabledPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa ini.
UIA_StructureChangedEventId

 

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI