Bagikan melalui

Tipe Kontrol Gambar

  • Artikel

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

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 Automasi 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 Automation UI, lihat Gambaran Umum Pohon Automasi UI .

Tampilan kontrol Tampilan konten
Citra Gambar (Tergantung apakah gambar berisi informasi, berdasarkan nilai properti Pengidentifikasi Properti Elemen Automation)

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol gambar. 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. Titik yang dapat diklik kontrol gambar harus menjadi 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 lainnya 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 Scalable Vector Graphics (SVG) Desc. Pengembang yang bekerja dengan kontrol gambar harus mendukung properti untuk memungkinkan deskripsi visual diatur pada kontrol. Properti ini harus dipetakan ke properti Automation UI VisualDescription.
UIA_IsContentElementPropertyId Lihat catatan. Kontrol gambar harus disertakan dalam tampilan konten pohon Automation UI ketika berisi informasi yang bermakna yang belum diekspos ke pengguna akhir.
UIA_IsControlElementPropertyId BENAR Kontrol gambar selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
UIA_ItemStatusPropertyId Lihat catatan. Jika kontrol gambar mewakili informasi status tentang item tertentu di layar, kontrol harus dimuat 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 "gambar" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Properti Nama harus diekspos untuk semua kontrol gambar yang berisi informasi. Akses terprogram ke informasi ini mengharuskan tekstual yang setara dengan grafik disediakan. Jika kontrol gambar murni dekoratif, kontrol hanya boleh muncul dalam tampilan kontrol pohon Automation UI dan tidak diharuskan memiliki nama (lihat Remarks). Kerangka kerja UI harus mendukung properti TEKS ALT atau alternatif pada gambar yang dapat diatur dari dalam kerangka kerjanya. Properti ini kemudian akan memetakan ke properti Nama Automasi UI.

Pola Kontrol yang Diperlukan

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

Pola Kontrol Dukung Catatan
IGridItemProvider Tergantung 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 (Hyperlink jenis kontrol) 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 Tergantung Kontrol gambar mendukung pola kontrol TableItem jika kontrol berada dalam kontainer yang memiliki kontrol header.

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol gambar untuk didukung. 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_ItemStatusPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiItemStatus, kontrol harus mendukung peristiwa ini.
UIA_NamePropertyId peristiwa yang diubah properti.
UIA_StructureChangedEventId

Komentar

World Wide Web Consortium (W3C) mendefinisikan gambar dekoratif sebagai gambar yang tidak menambahkan informasi ke konten halaman. Untuk detail selengkapnya, lihat topik W3C tentang 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 yang terkait dengan jelas yang menyediakan informasi yang sama (seperti tombol putar yang berisi grafik segitiga penunjuk 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