Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol Tooltip

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 ToolTip. 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 tips alat adalah jendela pop-up yang berisi teks.

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

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol tip alat 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
Keterangan Alat

- Teks (0 atau lebih)
- Gambar (0 atau lebih)		 Keterangan Alat

Kontrol tooltip hanya muncul di Tampilan Konten pohon Automation UI jika dapat menerima fokus keyboard. Jika tidak, semua informasi tip alat tersedia dari HelpTextProperty pada elemen UI Automation yang dirujuk oleh tip alat.

Tips alat akan muncul di bawah kontrol yang informasinya dirujuk. Klien-klien harus memantau ToolTipOpenedEvent untuk memastikan bahwa mereka secara konsisten mendapatkan informasi yang terkandung dalam tips alat.

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automasi UI yang nilai atau definisinya sangat relevan dengan kontrol tooltip. 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 harus menjadi bagian dari tip alat yang akan menonaktifkan kontrol. Beberapa tooltip tidak memiliki fitur ini dan tidak akan memiliki titik klik.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
NameProperty Lihat catatan. Nama kontrol tip alat adalah teks yang ditampilkan dalam tip alat.
LabeledByProperty Null Kontrol tooltip secara otomatis dilabeli oleh isinya.
ControlTypeProperty Keterangan Alat Nilai ini sama untuk semua kerangka kerja UI.
LocalizedControlTypeProperty "keterangan alat" String yang dilokalkan sesuai dengan jenis kontrol TipsAlat.
IsContentElementProperty Bergantung Jika kontrol tip alat dapat menerima fokus keyboard, kontrol tersebut harus berada di Tampilan Konten pohon. Jika hanya berupa teks, maka tersedia sebagai HelpTextProperty dari kontrol yang memicunya.
IsControlElementProperty Benar Kontrol tooltip harus selalu kontrol.

Pola Kontrol Automasi UI yang Diperlukan

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

Pola Kontrol Dukungan Catatan
IWindowProvider Bergantung Tooltip yang dapat ditutup dengan mengklik item UI harus mendukung WindowPattern sehingga 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 Automasi UI yang Diperlukan

Kontrol tooltip harus mengaktifkan ToolTipOpenedEvent ketika muncul di layar. Peristiwa ini akan menyertakan referensi ke elemen UI Automation dari tip alat itu sendiri.

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

Peristiwa Automasi UI Dukungan Catatan
TextSelectionChangedEvent Bergantung Tidak ada
TextChangedEvent Bergantung Tidak ada
WindowClosedEvent Bergantung Tidak ada
WindowOpenedEvent Bergantung Tidak ada
ToolTipOpenedEvent Diperlukan Tidak ada
ToolTipClosedEvent Diperlukan 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
WindowVisualStateProperty acara perubahan properti. Bergantung Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on