Bagikan melalui

Jenis Kontrol Pohon

  • Artikel

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

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

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Pohon . Persyaratan Otomatisasi 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 UI Automation, lihat Ringkasan Pohon UI Automation.

Tampilan Kontrol Tampilan Konten
  • Pohon
    • DataItem (0 atau lebih)
    • TreeItem (0 atau lebih)
      • TreeItem (0 atau lebih)
        • ...
    • ScrollBar (0, 1, 2)
  • Pohon
    • DataItem (0 atau lebih)
    • TreeItem (0 atau lebih)
      • TreeItem (0 atau lebih)
        • ...

 

Tampilan kontrol pohon UI Automation 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 Pohon . Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation 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. 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 TRUE Kontrol hierarki selalu disertakan dalam tampilan konten hierarki UI Automation.
UIA_IsControlElementPropertyId TRUE Kontrol hierarki selalu disertakan dalam tampilan kontrol hierarki UI Automation.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini.
UIA_LabeledByPropertyId Lihat catatan. Jika kontrol pohon memiliki label yang terkait dengannya, properti ini mengembalikan penunjuk IUIAutomationElement 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 UI Automation.

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

 

Peristiwa yang Diperlukan

Tabel berikut ini mencantumkan peristiwa Otomatisasi UI yang harus didukung oleh semua kontrol pohon. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.

Peristiwa UI Automation Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsEnabledPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti IsEnabled , kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung peristiwa ini.
UIA_ScrollHorizontallyScrollablePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_ScrollHorizontalScrollPercentPropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_ScrollHorizontalViewSizePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_ScrollVerticalScrollPercentPropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_ScrollVerticallyScrollablePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_ScrollVerticalViewSizePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Gulir , kontrol tersebut harus mendukung peristiwa ini.
UIA_Selection_InvalidatedEventId Jika kontrol mendukung pola kontrol Pilihan , kontrol harus mendukung kejadian ini.
UIA_StructureChangedEventId

 

Konseptual

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation