Dukungan UI Automation untuk Jenis Kontrol SplitButton
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 menyediakan informasi tentang dukungan UI Automation untuk jenis kontrol SplitButton. 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 tombol terpisah memungkinkan kemampuan untuk melakukan tindakan pada kontrol dan memperluas kontrol untuk melihat daftar tindakan lain yang mungkin dapat dilakukan.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa UI Automation yang diperlukan untuk jenis kontrol SplitButton. Persyaratan UI Automation berlaku untuk semua kontrol tombol terpisah, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon UI Automation yang berkaitan dengan kontrol tombol terpisah dan menjelaskan apa yang bisa dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 hingga banyak) |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol tombol terpisah. 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. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | "Kembali" | Nama kontrol tombol terpisah ditampilkan pada tombol. |
| LabeledByProperty | Null | Kontrol tombol terpisah tidak memiliki label teks statis. |
| ControlTypeProperty | SplitButton | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "tombol pemisah" | String yang dilokalkan sesuai dengan jenis kontrol SplitButton. |
| HelpTextProperty | Lihat catatan. | Teks bantuan dapat menunjukkan hasil mengaktifkan tombol pemisah, yang biasanya merupakan jenis informasi yang sama yang disajikan melalui keterangan alat. |
| IsContentElementProperty | Benar | Kontrol tombol pisahkan berisi informasi untuk pengguna akhir. |
| IsControlElementProperty | Benar | Kontrol tombol pemisah terlihat oleh pengguna akhir. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol tombol terpisah. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IInvokeProvider | Wajib | Tombol pemisah selalu memiliki tindakan default yang terkait dengan Panggil. |
| IExpandCollapseProvider | Wajib | Tombol pemisah selalu memiliki kemampuan untuk memperluas daftar opsi. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tombol terpisah. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvokedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
Contoh Kontrol SplitButton
Gambar berikut mengilustrasikan jenis kontrol SplitButton dalam kontrol kisi data.
Tampilan Kontrol dan Tampilan Konten pohon UI Automation yang berkaitan dengan kisi data dan kontrol tombol terpisah ditampilkan di bawah ini. Pola kontrol untuk setiap elemen automasi ditunjukkan dalam tanda kurung.
| Pohon Azure Automation Antarmuka Pengguna - Tampilan Kontrol | Pohon UI Automation - Tampilan Konten |
|---|---|
|
|