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.
Penyedia layanan UI Otomatisasi mengekspos properti pada elemen Microsoft UI Otomatisasi. Properti ini memungkinkan aplikasi klien Automation UI untuk menemukan informasi tentang potongan antarmuka pengguna (UI), terutama kontrol, termasuk data statis dan dinamis.
Bagian ini memberikan gambaran umum yang luas tentang properti Microsoft UI Automation. Informasi lebih spesifik diberikan dalam topik berikut:
Pengidentifikasi Properti
Setiap properti diidentifikasi dengan angka dan nama. Nama properti hanya digunakan untuk debugging dan diagnosis. Penyedia menggunakan ID numerik untuk mengidentifikasi permintaan properti masuk. Namun, aplikasi klien hanya menggunakan AutomationProperty, yang merangkum jumlah dan nama, untuk mengidentifikasi properti yang ingin mereka ambil.
AutomationProperty objek yang mewakili properti tertentu tersedia sebagai bidang di berbagai kelas. Untuk alasan keamanan, penyedia Automation UI mendapatkan objek ini dari sekumpulan kelas terpisah yang terkandung dalam Uiautomationtypes.dll.
Tabel berikut mengategorikan properti menurut kelas yang berisi AutomationPropertyID.
| Jenis properti | Klien mendapatkan ID dari | Penyedia mendapatkan ID dari |
|---|---|---|
| Properti umum untuk semua elemen (lihat tabel berikut) | AutomationElement | AutomationElementIdentifiers |
| Posisi jendela docking | DockPattern | DockPatternIdentifiers |
| Status elemen yang dapat diperluas dan diciutkan | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
| Properti dari suatu item dalam tabel | GridItemPattern | GridItemPatternIdentifiers |
| Properti kisi | GridPattern | GridPatternIdentifiers |
| Tampilan saat ini dan didukung dari elemen yang memiliki beberapa tampilan | MultipleViewPattern | MultipleViewPatternIdentifiers |
| Properti elemen yang bergeser dalam rentang nilai, seperti penggeser | RangeValuePattern | RangeValuePatternIdentifiers |
| Properti jendela gulir | ScrollPattern | ScrollPatternIdentifiers |
| Status dan wadah dari item yang dapat dipilih, seperti dalam daftar | SelectionItemPattern | SelectionItemPatternIdentifiers |
| Properti kontrol yang berisi item yang dapat dipilih | SelectionPattern | SelectionPatternIdentifiers |
| Kepala kolom dan baris dari item dalam tabel | TableItemPattern | TableItemPatternIdentifiers |
| Judul kolom dan baris serta orientasi tabel | TablePattern | TablePatternIdentifiers |
| Keadaan kontrol pengalih | TogglePattern | TogglePatternIdentifiers |
| Kemampuan elemen yang dapat dipindahkan, diputar, atau diubah ukurannya | TransformPattern | TransformPatternIdentifiers |
| Nilai dan kemampuan baca/tulis dari elemen yang memiliki nilai | ValuePattern | ValuePatternIdentifiers |
| Kapabilitas dan status jendela | WindowPattern | WindowPatternIdentifiers |
Properti berdasarkan Kategori
Tabel berikut mengategorikan properti yang ID-nya ditemukan di AutomationElement dan AutomationElementIdentifiers. Properti ini umum untuk semua kontrol. Semua kecuali beberapa dari mereka cenderung statis selama masa pakai aplikasi penyedia; sebagian besar properti dinamis dikaitkan dengan pola kontrol.
Kolom Akses Properti mencantumkan aksesor lain untuk setiap properti, selain GetCurrentPropertyValue dan GetCachedPropertyValue. Untuk informasi selengkapnya tentang mendapatkan properti dalam aplikasi klien, lihat Properti Automasi UI untuk Klien.
Nota
Untuk informasi spesifik tentang setiap properti, ikuti tautan di kolom Akses Properti .
Tampilkan Karakteristik
| Pengidentifikasi properti | Akses properti |
|---|---|
| BoundingRectangleProperty | BoundingRectangle |
| CultureProperty | N/a |
| HelpTextProperty | HelpText |
| IsOffscreenProperty | IsOffscreen |
| OrientationProperty | Orientation |
Jenis Elemen
| Pengidentifikasi properti | Akses properti |
|---|---|
| ControlTypeProperty | ControlType |
| IsContentElementProperty | IsContentElement |
| IsControlElementProperty | IsControlElement |
| ItemTypeProperty | ItemType |
| LocalizedControlTypeProperty | LocalizedControlType |
Identifikasi
Interaksi
Dukungan untuk Pola
Lain-lain
| Pengidentifikasi properti | Akses properti |
|---|---|
| IsRequiredForFormProperty | IsRequiredForForm |
| IsPasswordProperty | IsPassword |
| ItemStatusProperty | ItemStatus |
Lokalisasi
Penyedia Automasi UI harus menyajikan properti berikut dalam bahasa sistem operasi:
Properti dan Peristiwa
Konsep peristiwa perubahan properti terkait erat dengan properti dalam UI Automation. Untuk properti dinamis, aplikasi klien memerlukan cara untuk mengetahui bahwa nilai properti telah berubah, sehingga dapat memperbarui cache informasinya atau bereaksi terhadap informasi baru dengan cara lain.
Penyedia memunculkan peristiwa ketika sesuatu di UI berubah. Misalnya, jika kotak centang dipilih atau dikosongkan, peristiwa perubahan properti dihasilkan oleh implementasi pola Toggle penyedia. Penyedia dapat menaikkan peristiwa secara selektif, tergantung pada apakah ada klien yang mendengarkan peristiwa, atau mendengarkan peristiwa tertentu.
Tidak semua perubahan properti memunculkan peristiwa; hal tersebut sepenuhnya bergantung pada implementasi penyedia UI Automation untuk elemen. Misalnya, penyedia proksi standar untuk kotak daftar tidak memicu sebuah peristiwa ketika SelectionProperty mengalami perubahan. Dalam kasus ini, sebagai gantinya, aplikasi harus mendengarkan ElementSelectedEvent.
Para klien mendengarkan peristiwa dengan berlangganan pada mereka. Berlangganan peristiwa berarti membuat metode delegasi yang dapat menangani peristiwa, lalu meneruskan metode ke Automasi UI bersama dengan peristiwa tertentu yang akan ditangani dalam metode tersebut. Untuk peristiwa yang diubah properti khususnya, klien harus menerapkan AutomationPropertyChangedEventHandler.