Bagikan melalui

Tipe Kontrol Header

  • Artikel

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

Kontrol header menyediakan kontainer visual untuk label untuk baris atau kolom informasi.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Header. Persyaratan Automasi UI berlaku untuk semua kontrol header tempat 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 header 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
  • Header
    • HeaderItem (1 atau lebih)
 (Tidak berlaku)

 

Kontrol header selalu memiliki satu atau beberapa anak dalam tampilan kontrol pohon Automation UI.

Kontrol header tidak memiliki anak dalam tampilan konten pohon Automation UI.

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol header. 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 semua kontrol dalam aplikasi.
UIA_BoundingRectanglePropertyId Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
UIA_ClickablePointPropertyId Lihat catatan. Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang pembatas dapat diklik, dan elemen melakukan pengujian hit khusus, ambil alih dan berikan titik yang dapat diklik.
UIA_ControlTypePropertyId Header
UIA_IsContentElementPropertyId PALSU Kontrol header tidak disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId BENAR Kontrol header selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
UIA_LabeledByPropertyId NOL Kontrol header tidak memiliki label statis.
UIA_LocalizedControlTypePropertyId Lihat catatan. Nilai defaultnya adalah "header" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Kontrol header memerlukan nama jika ada lebih dari satu header baris atau lebih dari satu header kolom. Ini mengidentifikasi informasi dalam header.
UIA_OrientationPropertyId OrientationType_Horizontal atau OrientationType_Vertical Nilai properti ini mengekspos posisi kontrol header—apakah itu header baris (OrientationType_Horizontal) atau header kolom (OrientationType_Vertical).

 

Pola Kontrol yang Diperlukan

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

Pola Kontrol Dukung Catatan
ITransformProvider Tergantung Terapkan pola kontrol Transformasi jika kontrol header dapat diubah ukurannya.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol header 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