Tipe Kontrol ListItem

  • Artikel

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

Kontrol item daftar adalah contoh kontrol yang mengimplementasikan jenis kontrol ListItem .

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol ListItem . Persyaratan Otomatisasi UI berlaku untuk semua kontrol item daftar 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 item daftar dan menjelaskan apa yang bisa dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.

Tampilan Kontrol Tampilan Konten
  • ListItem
    • Gambar (0 atau lebih)
    • Teks (0 atau lebih)
    • Edit (0 atau lebih)
  • ListItem

 

Turunan dari kontrol item daftar dalam tampilan konten pohon Automation UI harus selalu menampilkan nol turunan. Jika struktur kontrol sedih sehingga item lain terkandung di bawah item daftar, maka harus mengikuti persyaratan untuk dukungan Automation UI untuk jenis kontrol TreeItem .

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan jenis kontrol ListItem . Untuk informasi selengkapnya tentang properti Otomatisasi UI, lihat Mengambil Properti dari Elemen Automasi 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. Alokasikan properti AutomationId untuk item daftar jika elemen diketahui konsisten di berbagai instans antarmuka pengguna. Jika item daftar diisi secara dinamis dan tidak dapat diprediksi, biarkan properti AutomationId kosong.
UIA_BoundingRectanglePropertyId Lihat catatan. Nilai properti ini harus mencakup area gambar dan konten teks dari item daftar.
UIA_ClickablePointPropertyId Bergantung Jika kontrol daftar memiliki titik yang dapat diklik (titik yang dapat diklik untuk menyebabkan daftar mengambil fokus), titik tersebut harus diekspos melalui properti ini. Jika kontrol daftar sepenuhnya dicakup oleh item daftar turunan, itu akan mengembalikan kesalahan UIA_E_NOCLICKABLEPOINT untuk menunjukkan bahwa klien harus meminta item di dalam kontrol daftar untuk titik yang dapat diklik.
UIA_ControlTypePropertyId ListItem Nilai ini sama untuk semua kerangka kerja UI.
UIA_HelpTextPropertyId Lihat catatan. Teks Bantuan untuk kontrol daftar harus menjelaskan mengapa pengguna diminta untuk membuat pilihan dari daftar opsi, yang biasanya merupakan jenis informasi yang sama yang disajikan melalui tooltip. Misalnya, "Pilih item untuk mengatur resolusi tampilan untuk monitor Anda".
UIA_IsContentElementPropertyId TRUE Kontrol daftar selalu disertakan dalam tampilan konten pohon UI Automation.
UIA_IsControlElementPropertyId TRUE Kontrol daftar selalu disertakan dalam tampilan kontrol pohon UI Automation.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontainer dapat menerima input keyboard, nilai properti ini harus TRUE.
UIA_IsOffscreenPropertyId Bergantung Properti ini harus mengembalikan nilai untuk apakah item daftar saat ini digulir ke tampilan dalam kontainer induk yang mengimplementasikan pola kontrol Gulir .
UIA_ItemStatusPropertyId Bergantung Jika kontrol berisi status yang sedang diperbarui secara dinamis, properti ini harus didukung sehingga teknologi bantuan dapat menerima pembaruan ketika status elemen berubah.
UIA_ItemTypePropertyId Bergantung Properti ini harus diekspos untuk kontrol item daftar yang mewakili objek yang mendasarinya. Kontrol item daftar ini biasanya memiliki ikon yang terkait dengan kontrol yang dikaitkan pengguna dengan objek yang mendasarinya.
UIA_LabeledByPropertyId Lihat catatan. Jika ada label teks statis maka properti ini harus mengekspos referensi ke kontrol tersebut.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol ListItem . Nilai defaultnya adalah "item daftar" untuk en-US atau English (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Nilai properti nama kontrol item daftar berasal dari label teks item.

 

Pola Kontrol yang Diperlukan

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

Pola Kontrol Dukungan Catatan
IExpandCollapseProvider Bergantung Jika item dapat dimanipulasi untuk menampilkan atau menyembunyikan informasi, pola kontrol ExpandCollapse harus diimplementasikan.
IGridItemProvider Bergantung Jika navigasi spasial item-ke-item didukung dalam kontainer daftar, dan kontainer disusun dalam baris dan kolom, pola kontrol GridItem harus diimplementasikan.
IInvokeProvider Bergantung Jika item memiliki perintah yang dapat dilakukan di atasnya, terpisah dari pilihan, pola Kontrol pemanggilan harus diimplementasikan. Ini biasanya merupakan tindakan yang terkait dengan mengklik dua kali kontrol item daftar. Contohnya adalah meluncurkan dokumen dari Windows Explorer, atau memutar file musik di Microsoft Pemutar Media Windows.
IScrollItemProvider Bergantung Jika item daftar terkandung dalam kontainer yang dapat digulir, pola kontrol ScrollItem harus diimplementasikan.
ISelectionItemProvider Bergantung Kontrol item daftar yang mendukung pilihan harus mengimplementasikan pola kontrol SelectionItem . Ini memungkinkan kontrol item daftar untuk disampaikan saat dipilih.
IToggleProvider Bergantung Jika item daftar dapat diperiksa dan tindakan tidak melakukan perubahan status pilihan, pola kontrol Alihkan harus diimplementasikan.
IValueProvider Bergantung Jika item dapat diedit, pola kontrol Nilai harus diimplementasikan. Perubahan pada kontrol item daftar akan menyebabkan perubahan pada nilai properti UIA_NamePropertyId dan UIA_ValueValuePropertyId .

 

Peristiwa yang Diperlukan

Tabel berikut ini mencantumkan peristiwa Automasi UI yang diperlukan untuk mendukung kontrol item daftar. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.

Peristiwa UI Automation Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_ExpandCollapseExpandCollapseStatePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol ExpandCollapse , kontrol harus mendukung peristiwa ini.
UIA_Invoke_InvokedEventId Jika kontrol mendukung pola Kontrol pemanggilan , kontrol harus mendukung peristiwa ini.
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_ItemStatusPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti ItemStatus , harus mendukung kejadian ini.
UIA_NamePropertyId peristiwa yang diubah properti.
UIA_SelectionItem_ElementAddedToSelectionEventId Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini.
UIA_SelectionItem_ElementSelectedEventId Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Hidupkan/Matikan , kontrol harus mendukung kejadian ini.
UIA_ValueValuePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol Nilai , kontrol harus mendukung peristiwa ini.

 

Keterangan

Jika kontainer menghosting item daftar, sarana navigasi utama harus masuk ke item daftar. Menempatkan fokus pada sublemen melalui navigasi daftar dapat membingungkan pengguna dan alat aksesibilitas. Jika kontainer menghosting daftar item vertikal, menekan tombol PANAH ATAS dan PANAH BAWAH harus menavigasi item, tetapi menekan tombol PANAH KANAN dan PANAH KIRI dapat menavigasi ke subelemen item yang difokuskan, seperti kolom daftar atau subelemen UI.

Konseptual

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation