Dukungan UI Automation untuk Jenis Kontrol Gambar
Catatan
Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.
Topik ini memberikan informasi tentang dukungan UI Automation untuk jenis kontrol Gambar. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
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 UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Gambar. Persyaratan UI Automation berlaku untuk semua kontrol gambar, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation 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 mengandung informasi (berdasarkan nilai properti IsContentElement)) |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan jenis kontrol Gambar. Untuk mendapatkan informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Titik kontrol gambar yang dapat diklik harus berupa titik di dalam kotak batas kontrol gambar. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | 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, maka hanya harus muncul di tampilan kontrol pohon UI Automation dan tidak perlu memiliki nama. 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. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, 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 UI Automation saat berisi informasi bermakna yang belum diekspos ke pengguna akhir. |
| IsControlElementProperty | Benar | Kontrol gambar selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| HelpTextProperty | Lihat catatan. | Properti HelpText mengekspos string lokal yang menjelaskan tampilan visual sebenarnya dari kontrol (misalnya, kotak merah dengan 'X' putih) atau informasi tooltip lain yang terkait dengan gambar. Properti ini harus didukung ketika deskripsi panjang diperlukan untuk menyampaikan lebih banyak informasi tentang kontrol gambar. Misalnya, bagan atau diagram yang rumit. Properti ini dipetakan 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 UI Automation. |
| ItemStatusProperty | Lihat catatan. | Jika kontrol gambar mewakili informasi status tentang item tertentu di layar, kontrol harus terkandung di dalam item. Saat gambar dimasukkan ke dalam item, item tersebut harus mendukung properti status dan meningkatkan pemberitahuan yang sesuai saat status berubah. Jika gambar adalah kontrol mandiri dan menyampaikan status, properti ini harus didukung. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol gambar. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IGridItemProvider | Bergantung | Kontrol gambar mendukung pola Item Kisi jika kontrol berada di dalam kontainer kisi. |
| ITableItemProvider | Bergantung | Kontrol gambar mendukung pola Item Tabel jika kontrol berada dalam kontainer yang memiliki kontrol header. |
| 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 seharusnya tidak mendukung pola Item Pilihan. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol gambar. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvokedEvent | Tidak pernah | Tidak |
| ElementAddedToSelectionEvent | Tidak pernah | Tidak |
| ElementRemovedFromSelectionEvent | Tidak pernah | Tidak |
| ElementSelectedEvent | Tidak pernah | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |