Dukungan UI Automation untuk Jenis Kontrol Tab
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 tipe kontrol Tab. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Ketentuan tersebut mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan UI Automation. pola kontrol.
Kontrol tab dianalogikan dengan pembagi di buku catatan atau label di lemari arsip. Dengan menggunakan kontrol tab, aplikasi dapat menentukan beberapa halaman untuk area yang sama dari jendela atau kotak dialog.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan kejadian untuk jenis kontrol Tab. Persyaratan UI Automation berlaku untuk semua kontrol tab, 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 tab 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 |
|---|---|
Tab
|
Tab - TabItem (1 atau lebih) |
Kontrol tab memiliki elemen Automation UI turunan berdasarkan jenis kontrol Item Tab. Saat item tab dikelompokkan (misalnya, seperti pada aplikasi Microsoft Office 2007) jenis kontrol Tab juga dapat menghosting jenis kontrol Grup untuk item tab yang dikelompokkan, seperti yang ditunjukkan struktur pohon berikut.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
Tab
|
Tab
|
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan jenis kontrol Tab. Untuk 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. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Kontrol tab jarang memerlukan properti Nama. |
| ClickablePointProperty | No | Kontrol tab tidak memiliki titik yang dapat diklik. |
| LabeledByProperty | Lihat catatan. | Kontrol tab biasanya memiliki label teks statis yang diekspos melalui properti ini. |
| ControlTypeProperty | Tab | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "tab" | String yang dilokalkan sesuai dengan jenis kontrol Tab. |
| IsKeyboardFocusableProperty | Benar | Jenis kontrol Tab harus dapat menerima fokus keyboard. Biasanya, klien Automation UI memanggil SetFocus pada kontrol tab dan salah satu itemnya akan meneruskan fokus keyboard ke kontrol tab. Dimungkinkan bagi beberapa kontainer tab untuk fokus tanpa mengatur fokus ke salah satu itemnya. |
| IsContentElementProperty | Benar | Kontrol tab selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol tab selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| OrientationProperty | Lihat catatan. | Kontrol tab harus selalu menunjukkan apakah diposisikan secara horizontal atau vertikal. |
Pola dan Properti Kontrol UI Automation yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol tab. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| ISelectionProvider | Ya | Semua kontrol tab harus mendukung pola Pemilihan. |
| IsSelectionRequired | Benar | Kontrol tab selalu mengharuskan pilihan dibuat. |
| CanSelectMultiple | Salah | Kontrol tab selalu merupakan wadah pilihan tunggal. |
| IScrollProvider | Bergantung | Pola Gulir harus didukung di kontrol tab memiliki widget yang memungkinkan sekumpulan item tab digulir. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tab. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Bergantung | Tidak |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Tidak |
| VerticalViewSizeProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |