Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 SplitButton. 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 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 Automation UI yang diperlukan untuk jenis kontrol SplitButton. Persyaratan Otomatisasi UI berlaku untuk semua kontrol tombol terpisah, 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 tombol terpisah 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 |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 sampai banyak) |
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan untuk kontrol tombol terpisah. 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 terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang 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 | Nol | Kontrol tombol terpisah tidak memiliki label teks statis. |
| ControlTypeProperty | SplitButton | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "tombol pisahkan" | String terlokalisasi yang sesuai dengan tipe kontrol SplitButton. |
| HelpTextProperty | Lihat catatan. | Teks bantuan dapat menunjukkan hasil mengaktifkan tombol pisahkan, yang biasanya merupakan jenis informasi yang sama yang disajikan melalui tipsalat. |
| IsContentElementProperty | Benar | Kontrol tombol pisahkan berisi informasi untuk pengguna akhir. |
| IsControlElementProperty | Benar | Kontrol tombol terpisah terlihat oleh pengguna akhir. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol tombol terpisah. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IInvokeProvider | Diperlukan | Tombol terpisah selalu memiliki tindakan default yang terkait dengan memanggil. |
| IExpandCollapseProvider | Diperlukan | Tombol terpisah selalu memiliki kemampuan untuk memperluas daftar opsi. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol tombol terpisah. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvokedEvent | Diperlukan | Tidak ada |
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| ExpandCollapseStateProperty acara perubahan properti. | Diperlukan | Tidak ada |
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |
Contoh Kontrol Tombol Split
Gambar berikut mengilustrasikan jenis kontrol SplitButton dalam kontrol kisi data.
Tampilan Kontrol dan Tampilan Konten pohon Automation UI yang berkaitan dengan kisi data dan kontrol tombol terpisah ditampilkan di bawah ini. Pola kontrol untuk setiap elemen otomatisasi ditampilkan dalam tanda kurung.
| Pohon Automasi UI - Tampilan Kontrol | Pohon Automasi UI - Tampilan Konten |
|---|---|
|
|