Dukungan UI Automation untuk Jenis Kontrol ToolTip
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 ToolTip. 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 tool tip adalah jendela pop-up yang berisi teks.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol ToolTip. Persyaratan UI Automation berlaku untuk semua kontrol tool tip, 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 tool tip dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| ToolTip - Teks (0 atau lebih) - Image (0 atau lebih) |
ToolTip |
Kontrol tool tip hanya muncul di Tampilan Konten dari pohon UI Automation jika mereka dapat menerima fokus keyboard. Jika tidak, semua informasi tool tip tersedia dari HelpTextProperty pada elemen UI Automation yang dirujuk oleh tool tip.
Tool tip akan muncul di bawah kontrol yang dirujuk oleh informasinya. Klien harus mendengarkan ToolTipOpenedEvent untuk memastikan bahwa mereka secara konsisten mendapatkan informasi yang terkandung dalam tool tip.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol tool tip. 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 yang dapat diklik harus menjadi bagian dari tool tip yang akan mengabaikan kontrol. Beberapa tool tip tidak memiliki kemampuan ini dan tidak akan memiliki titik yang dapat diklik. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama dari tool tip control adalah teks yang ditampilkan di dalam tool tip. |
| LabeledByProperty | Null |
Kontrol tool tip selalu diberi label sendiri oleh isinya. |
| ControlTypeProperty | ToolTip | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "tool tip" | String lokal yang sesuai dengan jenis kontrol ToolTip. |
| IsContentElementProperty | Bergantung | Jika kontrol tool tip dapat menerima fokus keyboard, kontrol tersebut harus dalam Tampilan Konten dari hierarki. Jika hanya teks, maka teks tersedia sebagai HelpTextProperty dari kontrol yang menaikkannya. |
| IsControlElementProperty | Benar | Kontrol tool tip harus selalu menjadi kontrol. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol tool tip. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IWindowProvider | Bergantung | Tool tip yang dapat ditutup dengan mengklik item UI harus mendukung WindowPattern sehingga dapat ditutup secara otomatis. |
| ITextProvider | Bergantung | Untuk aksesibilitas yang lebih baik, kontrol tool tip dapat mendukung pola kontrol teks, meskipun tidak diperlukan. Pola kontrol Teks berguna ketika teks memiliki gaya dan atribut yang kaya (misalnya, warna, tebal, dan miring). |
Peristiwa UI Automation yang Diperlukan
Kontrol tool tip harus menaikkan ToolTipOpenedEvent saat muncul di layar. Acara ini akan menyertakan referensi ke elemen UI Automation dari tool tip itu sendiri.
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tool tip. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| TextSelectionChangedEvent | Bergantung | Tidak |
| TextChangedEvent | Bergantung | Tidak |
| WindowClosedEvent | Bergantung | Tidak |
| WindowOpenedEvent | Bergantung | Tidak |
| ToolTipOpenedEvent | Wajib | Tidak |
| ToolTipClosedEvent | Wajib | 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 |
| WindowVisualStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |