Dukungan Automation UI untuk Jenis Kontrol DataGrid
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 Microsoft Azure Automation antarmuka pengguna untuk jenis kontrol DataGrid. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlType. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Jenis kontrol DataGrid memungkinkan pengguna dengan mudah bekerja dengan item yang berisi metadata yang diwakili dalam kolom. Kontrol kisi data memiliki baris item dan kolom informasi tentang item tersebut. Kontrol Tampilan Daftar di Microsoft Vista Explorer adalah contoh yang mendukung jenis kontrol DataGrid.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Azure Automation Antarmuka Pengguna yang diperlukan untuk jenis kontrol DataGrid. Persyaratan Azure Automation Antarmuka Pengguna berlaku untuk semua kontrol kisi data, 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 Azure Automation Antarmuka Pengguna yang berkaitan dengan kontrol kisi data dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Pohon Azure Automation Antarmuka Pengguna - Tampilan Kontrol | Pohon UI Automation - Tampilan Konten |
|---|---|
DataGrid
|
DataGrid - DataItem (0 atau lebih; dapat disusun dalam hierarki) |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti yang nilai atau definisinya sangat relevan dengan kontrol kisi data. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti | 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. |
| ControlTypeProperty | DataGrid | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Nilai properti ini harus selalu True. Ini berarti bahwa kontrol kisi data harus selalu berada dalam tampilan konten pohon Azure Automation Antarmuka Pengguna. |
| IsControlElementProperty | Benar | Nilai properti ini harus selalu True. Ini berarti bahwa kontrol kisi data harus selalu berada dalam tampilan kontrol pohon Azure Automation Antarmuka Pengguna. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, properti ini harus mengekspos referensi ke kontrol tersebut. |
| LocalizedControlTypeProperty | "data grid" | String yang dilokalkan sesuai dengan jenis kontrol DataGrid. |
| NameProperty | Lihat catatan. | Kontrol kisi data biasanya mendapatkan nilai untuk properti Namenya dari label teks statis. Jika tidak ada label teks statis, pengembang aplikasi harus menetapkan nilai untuk properti Name. Nilai properti Name tidak boleh menjadi konten tekstual kontrol edit. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol yang diperlukan untuk didukung oleh semua kontrol kisi data. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IGridProvider | Ya | Kontrol kisi data itu sendiri selalu mendukung pola kontrol Grid karena item yang berisi metadata yang ditata dalam kisi. |
| IScrollProvider | Bergantung | Kemampuan untuk menggulir kisi data tergantung pada konten dan apakah bilah gulir ada. |
| ISelectionProvider | Bergantung | Kemampuan untuk memilih kisi data tergantung pada konten. |
| ITableProvider | Ya | Kontrol kisi data selalu memiliki header dalam subtree-nya sehingga pola kontrol Tabel harus didukung. |
Item data dalam kontainer kisi data akan mendukung minimal:
Pola kontrol Item Pilihan (jika kisi data dapat dipilih)
Pola kontrol Gulir Item (jika kisi data dapat digulir)
Pola kontrol Item Kisi
Pola kontrol Item Tabel
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa Azure Automation Antarmuka pengguna yang diperlukan untuk didukung oleh semua kontrol kisi data. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| LayoutInvalidatedEvent | Bergantung | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| CurrentViewProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| VerticallyScrollableProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| VerticalViewSizeProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola Gulir, kontrol harus mendukung peristiwa ini. |
| InvalidatedEvent | Wajib | Tidak |
Contoh Tipe Kontrol Kisi Tanggal
Gambar berikut mengilustrasikan kontrol Tampilan Daftar yang mengimplementasikan jenis kontrol DataGrid.
Tampilan kontrol dan tampilan konten pohon Azure Automation Antarmuka Pengguna yang berkaitan dengan kontrol Tampilan Daftar 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 |
|---|---|
|
|
* Contoh sebelumnya menunjukkan DataGrid yang berisi beberapa tingkat kontrol. Kontrol Grup ("Contoso") berisi dua kontrol DataItem ("Accounts Receivable.doc" dan "Accounts Payable.doc"). Pasangan DataGrid/GridItem tidak bergantung pada pasangan di tingkat lain. Kontrol DataItem di bawah Grup juga dapat diekspos sebagai jenis kontrol ListItem, memungkinkannya disajikan dengan lebih jelas sebagai objek yang dapat dipilih, bukan sebagai elemen data sederhana. Contoh ini tidak menyertakan sub-elemen item data yang dikelompokkan.