Bagikan melalui

Tipe Kontrol Gambar

  • Artikel

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

Kontrol gambar yang digunakan sebagai ikon, grafik informasi, dan bagan akan mendukung jenis kontrol Gambar . Kontrol yang digunakan sebagai gambar latar belakang atau marka air tidak akan mendukung jenis kontrol Gambar .

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Gambar . Persyaratan Otomatisasi UI berlaku untuk semua kontrol gambar 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 gambar 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
Gambar Gambar (Tergantung apakah gambar berisi informasi, berdasarkan nilai properti Pengidentifikasi Properti Elemen Automation )

Properti yang Relevan

Tabel berikut mencantumkan properti Otomatisasi UI yang nilai atau definisinya sangat relevan dengan kontrol gambar. 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.
UIA_BoundingRectanglePropertyId Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
UIA_ClickablePointPropertyId Lihat catatan. Titik yang dapat diklik kontrol gambar harus merupakan titik dalam persegi panjang pembatas kontrol gambar.
UIA_ControlTypePropertyId Gambar
UIA_HelpTextPropertyId Lihat catatan. Properti HelpText mengekspos string yang dilokalkan yang menjelaskan tampilan visual kontrol aktual atau informasi tipsalat lain yang terkait dengan gambar. Properti ini harus didukung ketika deskripsi panjang diperlukan untuk menyampaikan informasi selengkapnya tentang kontrol gambar (misalnya, jika gambar adalah bagan atau diagram yang rumit). Properti ini memetakan ke tag Html LongDesc dan tag Desc Scalable Vector Graphics (SVG). Pengembang yang bekerja dengan kontrol gambar harus mendukung properti untuk memungkinkan deskripsi visual diatur pada kontrol. Properti ini harus dipetakan ke properti VisualDescription Automation UI.
UIA_IsContentElementPropertyId Lihat catatan. Kontrol gambar harus disertakan dalam tampilan konten pohon UI Automation saat berisi informasi bermakna yang belum diekspos ke pengguna akhir.
UIA_IsControlElementPropertyId TRUE Kontrol gambar selalu disertakan dalam tampilan kontrol pohon UI Automation.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini.
UIA_ItemStatusPropertyId Lihat catatan. Jika kontrol gambar mewakili informasi status tentang item tertentu di layar, kontrol harus terkandung di dalam item. Saat gambar terkandung dalam item, item harus mendukung properti status dan menaikkan pemberitahuan yang sesuai saat status berubah. Jika gambar adalah kontrol mandiri dan menyampaikan status, properti ini harus didukung.
UIA_LabeledByPropertyId Lihat catatan. Jika ada label teks statis, properti ini harus mengekspos referensi ke kontrol tersebut.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol Gambar . Nilai defaultnya adalah "image" untuk en-US atau English (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Properti Nama harus diekspos untuk semua kontrol gambar yang berisi informasi. Akses terprogram ke informasi ini memerlukan teks yang setara dengan grafik yang disediakan. Jika kontrol gambar murni dekoratif, kontrol hanya boleh muncul dalam tampilan kontrol pohon Automation UI dan tidak diperlukan untuk memiliki nama (lihat Keterangan). Kerangka kerja UI harus mendukung ALT atau properti teks alternatif pada gambar yang dapat diatur dari dalam kerangka kerja mereka. Properti ini kemudian akan dipetakan ke properti Nama UI Automation.

Pola Kontrol yang Diperlukan

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

Pola Kontrol Dukungan Catatan
IGridItemProvider Bergantung Kontrol gambar mendukung pola kontrol GridItem jika kontrol berada dalam kontainer kisi.
IInvokeProvider Tidak pernah Jika kontrol gambar adalah objek yang dapat diklik, kontrol harus mendukung jenis kontrol yang mendukung pola kontrol Panggil , seperti jenis kontrol Tombol . Untuk objek gambar yang berisi beberapa objek yang dapat diklik, elemen (Jenis kontrol gambar) dapat menghosting tautan anak (Jenis kontrol hyperlink ) di pohon Automation UI.
ISelectionItemProvider Tidak pernah Kontrol gambar tidak boleh mendukung pola kontrol SelectionItem . Jika gambar adalah bagian dari kontainer yang dapat dipilih seperti tombol yang memiliki ikon gambar sebagai konten, kontainer tersebut mendukung pola, bukan gambar di dalamnya.
ITableItemProvider Bergantung Kontrol gambar mendukung pola kontrol TableItem jika kontrol berada dalam kontainer yang memiliki kontrol header.

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automation UI yang diperlukan kontrol gambar untuk didukung. 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 kejadian ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung kejadian ini.
UIA_ItemStatusPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti ItemStatus , kontrol harus mendukung kejadian ini.
UIA_NamePropertyId peristiwa yang diubah properti.
UIA_StructureChangedEventId

Keterangan

World Wide Web Consortium (W3C) mendefinisikan gambar dekoratif sebagai gambar yang tidak menambahkan informasi ke konten halaman. Untuk detail selengkapnya, lihat topik W3C pada gambar dekoratif.

Sehubungan dengan Automasi UI:

  • Jika gambar murni dekoratif, tidak interaktif, dan tidak menyampaikan informasi, gambar:
    • Mungkin atau mungkin tidak berada di pohon UIA
    • Mungkin atau mungkin tidak dalam tampilan mentah UIA
    • Tidak boleh berada dalam tampilan kontrol UIA
    • Tidak boleh ada dalam tampilan konten
    • Mungkin atau mungkin tidak memiliki nama
  • Jika gambar menyampaikan informasi, tetapi ada teks terkait dengan jelas yang memberikan informasi yang sama (seperti tombol putar yang berisi grafik segitiga menunjuk kiri bersama dengan teks "putar"), gambar dianggap dekoratif dan gambar:
    • Harus dalam tampilan mentah
    • Harus dalam tampilan kontrol
    • Tidak boleh ada dalam tampilan konten
    • Mungkin atau mungkin tidak memiliki nilai dalam properti Nama
    • Teks yang juga menyampaikan arti gambar harus dalam tampilan konten
  • Jika gambar informatif dan menyampaikan detail yang tidak disediakan oleh teks terkait, gambar:
    • Harus dalam tampilan mentah
    • Harus dalam tampilan kontrol
    • Harus dalam tampilan konten
    • Harus memiliki nilai nama yang menjelaskan gambar dan maknanya

Konseptual