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 Microsoft UI Automation untuk jenis kontrol DataItem. 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.
Entri dalam daftar Kontak adalah contoh kontrol item data. Kontrol item data berisi informasi yang menarik bagi pengguna akhir. Ini lebih rumit daripada item daftar sederhana karena berisi informasi yang lebih kaya.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol DataItem. Persyaratan Otomatisasi UI berlaku untuk semua kontrol item data, 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 item data dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI .
| Pohon Automasi UI - Tampilan Kontrol | Pohon Automasi UI - Tampilan Konten |
|---|---|
| DataItem - Bervariasi (0 atau lebih; dapat disusun dalam hierarki) |
DataItem - Bervariasi (0 atau lebih; dapat disusun dalam hierarki) |
Elemen item data dalam kisi data dapat menghosting berbagai objek, termasuk lapisan item data lain, atau elemen kisi tertentu seperti teks, gambar, atau kontrol edit. Jika elemen item data memiliki peran objek tertentu, elemen harus diekspos sebagai jenis kontrol tertentu; misalnya, jenis kontrol ListItem untuk item data yang dapat dipilih di kisi.
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti yang nilai atau definisinya sangat relevan dengan kontrol item data. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.
| Harta benda | 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. |
| ControlTypeProperty | DataItem | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Kontrol item data harus selalu berupa konten. |
| IsControlElementProperty | Benar | Kontrol item data harus selalu menjadi kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| ItemStatusProperty | Lihat catatan. | Jika kontrol berisi status yang sedang diperbarui secara dinamis, properti ini harus didukung sehingga teknologi bantuan dapat menerima pembaruan ketika status elemen berubah. |
| ItemTypeProperty | Lihat catatan. | Ini adalah nilai string yang disampaikan kepada pengguna akhir objek dasar yang diwakili item. Contohnya adalah "File Media" atau "Kontak". |
| LabeledByProperty | Null |
Kontrol item data tidak memiliki label teks statis. |
| LocalizedControlTypeProperty | item data | String yang dilokalkan sesuai dengan jenis kontrol DataItem. |
| NameProperty | Lihat catatan. | Kontrol item data selalu berisi elemen teks utama yang berkaitan dengan apa yang akan dikaitkan pengguna sebagai pengidentifikasi paling semantik untuk item tersebut. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol Microsoft UI Automation yang diperlukan untuk didukung oleh semua kontrol item data. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IExpandCollapseProvider | Bergantung | Jika item data dapat dikembangkan atau disusutkan untuk menampilkan dan menyembunyikan informasi, pola Kembangkan-Susutkan harus didukung. |
| IGridItemProvider | Bergantung | Item data akan mendukung pola 'Grid Item' saat kumpulan item data tersedia dalam kontainer yang dapat dinavigasi dari item ke item. |
| IScrollItemProvider | Bergantung | Semua item data mendukung kemampuan untuk digulir ke tampilan dengan pola Gulir Item saat kontainer data mereka memiliki lebih banyak item daripada yang dapat pas di layar. |
| ISelectionItemProvider | Ya | Semua item data harus mendukung pola Item Pilihan untuk menunjukkan kapan item dipilih. |
| ITableItemProvider | Bergantung | Jika item data terkandung dalam jenis kontrol Data Grid maka item tersebut akan mendukung pola ini. |
| IToggleProvider | Bergantung | Jika item data berisi status yang dapat diputar. |
| IValueProvider | Bergantung | Jika teks utama item data dapat diedit, pola Nilai harus didukung. |
Bekerja dengan Elemen Data dalam Daftar Besar
Daftar besar seringkali divirtualisasikan data dalam kerangka kerja UI untuk membantu performa. Karena itu, klien Automation UI tidak dapat menggunakan fitur kueri dalam Automation UI untuk mengambil konten dari keseluruhan pohon, seperti yang dapat dilakukan pada kontainer item lain. Klien harus menggulir item ke dalam tampilan (atau memperluas kontrol untuk menampilkan semua opsi berharga)sebelum mengakses kumpulan informasi lengkap dari item data.
Saat memanggil SetFocus pada elemen UI Automation untuk item data, interaksi dengan Microsoft Windows Explorer akan berhasil mengembalikan dan menyebabkan fokus diatur ke bagian Edit dalam subtree item data.
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol item data. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| NameProperty acara perubahan properti. | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |
| InvokedEvent | Bergantung | Tidak ada |
| ExpandCollapseStateProperty acara perubahan properti. | Bergantung | Tidak ada |
| ElementAddedToSelectionEvent | Diperlukan | Tidak ada |
| ElementRemovedFromSelectionEvent | Diperlukan | Tidak ada |
| ElementSelectedEvent | Diperlukan | Tidak ada |
| ToggleStateProperty acara perubahan properti. | Bergantung | Tidak ada |
| ValueProperty acara perubahan properti. | Bergantung | Tidak ada |
Contoh Tipe Kontrol DataItem
Gambar berikut mengilustrasikan tipe kontrol DataItem yang dalam kontrol Tampilan Daftar dengan dukungan untuk informasi mendalam pada kolom.
Tampilan Kontrol dan Tampilan Konten pohon Automation UI yang berkaitan dengan kontrol item data ditampilkan di bawah ini. Pola kontrol untuk setiap elemen otomatisasi ditampilkan dalam tanda kurung. Grup "Contoso" juga merupakan bagian dari kontrol host pada Data Grid.
| Pohon Automasi UI - Tampilan Kontrol | Pohon Automasi UI - Tampilan Konten |
|---|---|
| - Grup "Contoso" (Tabel, Grid) - DataItem "Piutang Dagang.doc" (TableItem, GridItem, SelectionItem, Invoke) - Gambar "Akun Piutang.doc" - Edit "Nama" (TableItem, GridItem, Nilai "Piutang Usaha.doc") - Edit "Tanggal diubah" (TableItem, GridItem, Nilai "25/8/2006 15:29 PM") - Edit "Ukuran" (GridItem, TableItem, Nilai "11,0 KB") - DataItem "Akun Hutang.doc" (TableItem, GridItem, SelectionItem, Invoke) - ... |
- Grup "Contoso" (Tabel, Grid) - DataItem "Piutang Dagang.doc" (TableItem, GridItem, SelectionItem, Invoke) - Gambar "Akun Piutang.doc" - Edit "Nama" (TableItem, GridItem, Nilai "Piutang Usaha.doc") - Edit "Tanggal diubah" (TableItem, GridItem, Nilai "25/8/2006 15:29 PM") - Edit "Ukuran" (GridItem, TableItem, Nilai "11,0 KB") - DataItem "Akun Hutang.doc" (TableItem, GridItem, SelectionItem, Invoke) - … |
Jika kisi mewakili daftar item yang dapat dipilih, elemen UI yang sesuai dapat diekspos dengan jenis kontrol ListItem alih-alih jenis kontrol DataItem. Dalam contoh sebelumnya, elemen DataItem ("Accounts Receivable.doc" dan "Accounts Payable.doc") di bawah Kelompok ("Contoso") dapat ditingkatkan dengan mengeksposnya sebagai jenis kontrol ListItem karena jenis tersebut sudah mendukung pola kontrol SelectionItem.