Bagikan melalui


Kontrol Tampilan Pohon (Referensi Elemen UI MSAA)

Catatan

Topik ini menjelaskan objek Kontrol Tampilan Pohon untuk tujuan Referensi Elemen UI MSAA. Cara membuat objek Kontrol Tampilan Pohon di berbagai kerangka kerja UI tidak dijelaskan di sini. Lihat dokumentasi referensi API untuk kerangka kerja UI yang Anda gunakan.

Kontrol tampilan pohon menampilkan daftar hierarkis item menggunakan garis untuk menyambungkan item terkait dalam hierarki. Setiap item terdiri dari label dan bitmap opsional. Windows Explorer menggunakan kontrol tampilan pohon untuk menampilkan direktori.

Nama kelas jendela untuk kontrol tampilan pohon WC_TREEVIEW, yang didefinisikan sebagai "SysTreeView" di Commctrl.h.

Metode IAccessible

Kontrol tampilan pohon mendukung metode IAccessible berikut:

Metode Komentar
accDoDefaultAction Objek tampilan pohon itu sendiri tidak memiliki metode accDoDefaultAction . Bergantung pada properti Status item dalam tampilan pohon, accDoDefaultAction memperluas atau menciutkan item yang ditentukan.
accHitTest
accLocation
accNavigate
accSelect

Properti IAccessible

Kontrol tampilan pohon mendukung properti IAccessible berikut:

Properti Komentar
get_accChild
get_accChildCount Properti ChildCount untuk objek tampilan pohon adalah jumlah item yang terkandung dalam tampilan pohon. Properti ChildCount untuk setiap item tampilan pohon adalah nol.
get_accDefaultAction Objek tampilan pohon itu sendiri tidak memiliki properti DefaultAction . Item dalam tampilan pohon yang diperluas memiliki "Ciutkan" sebagai properti DefaultAction-nya , dan item yang tidak diperluas memiliki "Perluas" sebagai properti DefaultAction-nya .
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName Properti Nama untuk objek tampilan pohon diperoleh dari teks jendela kontrol (atau caption). Teks ini tidak ditampilkan dengan kontrol tampilan pohon, sehingga pengembang server harus memberikan teks yang bermakna dalam pernyataan definisi sumber daya kontrol untuk membantu pengguna utilitas klien mengidentifikasi kontrol. Properti Nama untuk item dalam tampilan pohon adalah teks yang ditampilkan dalam item tampilan pohon.
get_accParent Properti Induk dari objek tampilan pohon adalah jendela ( ROLE_SYSTEM_WINDOW ) yang mengelilingi kontrol dan memiliki properti Nama dan nama kelas jendela yang sama dengan kontrol. Properti Induk dari setiap item dalam tampilan pohon adalah objek tampilan pohon.
get_accRole Objek tampilan pohon memiliki properti PeranROLE_SYSTEM_OUTLINE. Setiap item dalam tampilan pohon memiliki properti PeranROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState Properti Status untuk tampilan pohon adalah kombinasi dari satu atau beberapa nilai berikut: STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
Untuk item tampilan pohon, properti Status menyertakan STATE_SYSTEM_EXPANDED atau STATE_SYSTEM_COLLAPSED.
Nilai tambahan yang mungkin untuk properti Status meliputi:
| STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_HOTTRACKED
get_accValue Objek tampilan pohon tidak memiliki nilai. Properti Nilai untuk setiap item tampilan pohon adalah tingkat indentasi item dalam hierarki. Misalnya, di Windows Explorer, item "Desktop" memiliki properti Nilai "0"; item "Komputer Saya", yang berada di tingkat berikutnya dalam hierarki, memiliki properti Nilai "1"; dan setiap drive disk, yang berada di tingkat berikutnya dalam hierarki, memiliki properti Nilai "2".

Catatan

Properti accLocation item tampilan pohon mengembalikan lokasi hanya teks dalam item. Koordinat yang dikembalikan oleh accLocation untuk item tampilan pohon tidak menyertakan ikon yang terletak di sebelah kiri teks.

Antarmuka IAccessible