Bagikan melalui

Jenis Kontrol Pohon

  • Artikel

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

Jenis kontrol Tree digunakan untuk kontainer yang kontennya memiliki relevansi sebagai hierarki simpul, seperti halnya cara file dan folder ditampilkan di panel kiri Windows Explorer. Setiap simpul memiliki potensi untuk berisi simpul lain, yang disebut simpul anak. Simpul induk, atau simpul yang berisi simpul anak, dapat ditampilkan sebagai diperluas atau diciutkan. Kontrol tampilan pohon Windows (seperti yang diidentifikasi oleh WC_TREEVIEW) adalah contoh kontrol milik jenis kontrol Pohon.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Pohon. Persyaratan Automasi UI berlaku untuk semua kontrol item pohon 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 pohon, 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
  • Pohon
    • DataItem (0 atau lebih)
    • TreeItem (0 atau lebih)
      • TreeItem (0 atau lebih)
        • ...
    • Bilah Gulir (0, 1, 2)
  • Pohon
    • DataItem (0 atau lebih)
    • TreeItem (0 atau lebih)
      • TreeItem (0 atau lebih)
        • ...

 

Tampilan kontrol pohon Automation UI terdiri dari:

  • Nol dari banyak item dalam kontainer (item dapat didasarkan pada jenis kontrol TreeItem atau DataItem).
  • Kontrol bilah gulir nol, satu, atau dua

Tampilan konten pohon Automation UI terdiri dari nol atau banyak item dalam kontainer (item dapat didasarkan pada jenis kontrol TreeItem atau DataItem).

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan jenis kontrol Tree. 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. Kontrol pohon memiliki titik yang dapat diklik yang menyebabkan pohon atau salah satu item dalam kontainer pohon menerima fokus. Kontrol pohon dapat memiliki titik yang dapat diklik hanya jika memungkinkan untuk mengklik lokasi di pohon tanpa menyebabkan item dipilih atau menerima fokus.
UIA_ControlTypePropertyId Pohon Nilai ini sama untuk semua kerangka kerja UI.
UIA_IsContentElementPropertyId BENAR Kontrol pohon selalu disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId BENAR Kontrol pohon 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 Lihat catatan. Jika kontrol pohon memiliki label yang terkait dengannya, properti ini mengembalikan IUIAutomationElement pointer untuk label tersebut. Jika tidak, properti mengembalikan referensi null.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol Pohon. Nilai defaultnya adalah "tree" untuk en-US atau English (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Nilai properti nama kontrol pohon biasanya berasal dari teks yang melabeli kontrol. Jika tidak ada label teks, Anda harus memberikan nilai untuk properti ini.

 

Pola Kontrol yang Diperlukan

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

Properti Pola/Pola Kontrol Dukungan/Nilai Catatan
IScrollProvider Tergantung Terapkan pola kontrol Scroll jika item dalam kontainer pohon dapat digulir.
ISelectionProvider Tergantung Kontrol pohon yang berisi sekumpulan item yang dapat dipilih harus mengimplementasikan pola kontrol Pilihan. Ini tidak perlu diimplementasikan jika memilih item tidak menyampaikan informasi yang bermakna kepada pengguna.
CanSelectMultiple Lihat catatan. Terapkan properti ini jika kontrol pohon mendukung beberapa pilihan (sebagian besar kontrol pohon tidak mendukung beberapa pilihan).
IsSelectionRequired Lihat catatan. Nilai properti ini diekspos jika kontrol mengharuskan item dipilih.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang harus didukung oleh semua kontrol pohon. 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_ScrollHorizontallyScrollablePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_ScrollHorizontalScrollPercentPropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_ScrollHorizontalViewSizePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticalScrollPercentPropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticallyScrollablePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_ScrollVerticalViewSizePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Scroll, kontrol harus mendukung peristiwa ini.
UIA_Selection_InvalidatedEventId Jika kontrol mendukung pola kontrol Pilihan, kontrol harus mendukung peristiwa ini.
UIA_StructureChangedEventId

 

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI