Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol Gambar

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol Gambar. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.

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

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Gambar. Persyaratan Otomatisasi UI berlaku untuk semua kontrol gambar, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol 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 Isi
Gambar Gambar (Tergantung apakah gambar berisi informasi (berdasarkan nilai IsContentElement properti))

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan jenis kontrol Gambar. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AutomationIdProperty Lihat catatan. Nilai properti ini harus unik di semua kontrol dalam aplikasi.
BoundingRectangleProperty Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
ClickablePointProperty Lihat catatan. Titik yang dapat diklik kontrol gambar harus menjadi titik dalam persegi panjang pembatas kontrol gambar.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
NameProperty 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 diperlukan untuk memiliki nama. 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.
LabeledByProperty Lihat catatan. Jika ada label teks statis, maka properti ini harus mengekspos referensi ke kontrol tersebut.
ControlTypeProperty Gambar Nilai ini sama untuk semua kerangka kerja UI.
LocalizedControlTypeProperty "gambar" String yang dilokalkan sesuai dengan jenis kontrol Gambar.
IsContentElementProperty Lihat catatan. Kontrol gambar harus disertakan dalam tampilan konten pohon Automation UI ketika berisi informasi yang bermakna yang belum diekspos ke pengguna akhir.
IsControlElementProperty Benar Kontrol gambar selalu disertakan dalam tampilan kontrol pohon Automation UI.
HelpTextProperty Lihat catatan. Properti HelpText mengekspos string yang dilokalkan yang menjelaskan tampilan visual kontrol aktual (misalnya, persegi merah dengan 'X') putih atau informasi tipsalat lain yang terkait dengan gambar.

Properti ini harus didukung ketika deskripsi panjang diperlukan untuk menyampaikan informasi lebih lanjut tentang kontrol gambar. Misalnya, bagan atau diagram yang rumit. Properti ini memetakan tag HTML LongDesc dan tag Desc dari 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.
ItemStatusProperty Lihat catatan. Jika kontrol gambar mewakili informasi status tentang item tertentu di layar, kontrol harus dimuat dalam item. Ketika 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.

Pola Kontrol Automasi UI yang Diperlukan

Tabel berikut mencantumkan pola kontrol otomatisasi UI yang harus didukung oleh semua kontrol gambar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.

Pola Kontrol Dukungan Catatan
IGridItemProvider Bergantung Kontrol gambar mendukung pola Item Kisi jika kontrol berada dalam kontainer kisi.
ITableItemProvider Bergantung Kontrol gambar mendukung pola Item Tabel jika kontrol berada dalam kontainer yang memiliki kontrol tajuk.
IInvokeProvider Tidak pernah Jika kontrol gambar berisi gambar yang dapat diklik, kontrol harus mendukung jenis kontrol yang mendukung pola Invoke, seperti jenis kontrol Tombol.
ISelectionItemProvider Tidak pernah Kontrol gambar tidak boleh mendukung pola Item Pilihan.

Peristiwa Automasi UI yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol gambar. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI Dukungan Catatan
InvokedEvent Tidak pernah Tidak ada
ElementAddedToSelectionEvent Tidak pernah Tidak ada
ElementRemovedFromSelectionEvent Tidak pernah Tidak ada
ElementSelectedEvent Tidak pernah Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on