Pengidentifikasi Properti Elemen Automation
Topik ini menjelaskan konstanta bernama yang mengidentifikasi properti elemen Microsoft UI Automation.
| Konstanta/nilai | Deskripsi |
|---|---|
|
Mengidentifikasi properti AcceleratorKey , yang merupakan string yang berisi kombinasi tombol akselerator (juga disebut tombol pintasan) untuk elemen otomatisasi. Kombinasi tombol pintasan memanggil tindakan. Misalnya, CTRL+O sering digunakan untuk memanggil kotak dialog Buka file umum. Elemen otomatisasi yang memiliki properti AcceleratorKey dapat mengimplementasikan pola kontrol Panggil untuk tindakan yang setara dengan perintah pintasan. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti AccessKey , yang merupakan string yang berisi karakter kunci akses untuk elemen otomatisasi. Kunci akses (terkadang disebut mnemonic) adalah karakter dalam teks menu, item menu, atau label kontrol seperti tombol, yang mengaktifkan fungsi menu terkait. Misalnya, untuk membuka menu File, yang tombol aksesnya biasanya F, pengguna akan menekan ALT+F. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti AnotasiObjects , yang merupakan daftar objek anotasi dalam dokumen, seperti komentar, header, footer, dan sebagainya. Jenis varian: VT_ARRAY VT_I4 | Nilai default: array kosong |
|
Mengidentifikasi properti AnnotationTypes , yang merupakan daftar jenis anotasi dalam dokumen, seperti komentar, header, footer, dan sebagainya. Jenis varian: VT_ARRAY VT_I4 | Nilai default: array kosong |
|
Mengidentifikasi properti AriaProperties , yang merupakan string berformat yang berisi informasi properti Aplikasi Internet Kaya (ARIA) yang Dapat Diakses untuk elemen otomatisasi. Untuk informasi selengkapnya tentang pemetaan status dan properti ARIA ke properti dan fungsi Automation UI, lihat Automasi UI untuk Spesifikasi Aplikasi Internet Kaya yang Dapat Diakses W3C. AriaProperties adalah kumpulan pasangan Nama/Nilai dengan pemisah = (sama dengan) dan ; (titik koma), misalnya, "checked=true;disabled=false". \ (garis miring terbalik) digunakan sebagai karakter escape saat karakter pemisah ini atau \ muncul dalam nilai. Untuk alasan keamanan dan lainnya, implementasi penyedia properti ini dapat mengambil langkah-langkah untuk memvalidasi properti ARIA asli; namun, itu tidak diperlukan. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti AriaRole , yang merupakan string yang berisi informasi peran Aplikasi Internet Kaya yang Dapat Diakses (ARIA) untuk elemen otomatisasi. Untuk informasi selengkapnya tentang pemetaan peran ARIA ke jenis kontrol Automation UI, lihat Automasi UI untuk Spesifikasi Aplikasi Internet Kaya yang Dapat Diakses W3C. Catatan:
|
|
Mengidentifikasi properti AutomationId , yang merupakan string yang berisi pengidentifikasi Otomatisasi UI (ID) untuk elemen otomatisasi. Ketika tersedia, AutomationId dari elemen harus sama dalam instans aplikasi apa pun, terlepas dari bahasa lokal. Nilainya harus unik di antara elemen saudara kandung, tetapi belum tentu unik di seluruh desktop. Misalnya, beberapa instans aplikasi, atau beberapa tampilan folder di Microsoft Windows Explorer, dapat berisi elemen dengan properti AutomationId yang sama, seperti "SystemMenuBar". Meskipun dukungan untuk AutomationId selalu direkomendasikan untuk dukungan pengujian otomatis yang lebih baik, properti ini tidak wajib. Jika didukung, AutomationId berguna untuk membuat skrip otomatisasi pengujian yang berjalan terlepas dari bahasa UI. Klien tidak boleh membuat asumsi mengenai nilai AutomationId yang diekspos oleh aplikasi lain. AutomationId tidak dijamin stabil di berbagai rilis atau build aplikasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti BoundingRectangle , yang menentukan koordinat persegi panjang yang sepenuhnya mencakup elemen otomatisasi. Persegi panjang dinyatakan dalam koordinat layar fisik. Ini dapat berisi titik yang tidak dapat diklik jika bentuk atau wilayah yang dapat diklik dari item UI tidak teratur, atau jika item dikaburkan oleh elemen UI lainnya. Jenis varian: VT_R8 | VT_ARRAY Nilai default: [0,0,0,0] Catatan:
|
|
Mengidentifikasi properti CenterPoint , yang menentukan koordinat titik X dan Y tengah dari elemen otomatisasi. Ruang koordinat adalah apa yang secara logis dipertimbangkan oleh penyedia halaman. Jenis varian: VT_R8 | VT_ARRAY Nilai default: VT_EMPTY |
|
Mengidentifikasi properti ClassName , yang merupakan string yang berisi nama kelas untuk elemen otomatisasi seperti yang ditetapkan oleh pengembang kontrol. Nama kelas tergantung pada implementasi penyedia Automation UI dan oleh karena itu tidak selalu dalam format standar. Namun, jika nama kelas diketahui, itu dapat digunakan untuk memverifikasi bahwa aplikasi bekerja dengan elemen otomatisasi yang diharapkan. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti ClickablePoint , yang merupakan titik pada elemen otomatisasi yang dapat diklik. Elemen tidak dapat diklik jika benar-benar atau sebagian dikaburkan oleh jendela lain. Jenis varian: VT_R8 | VT_ARRAY Nilai default: VT_EMPTY |
|
Mengidentifikasi properti ControllerFor , yang merupakan array elemen otomatisasi yang dimanipulasi oleh elemen otomatisasi yang mendukung properti ini. ControllerFor digunakan ketika elemen otomatisasi memengaruhi satu atau beberapa segmen UI aplikasi atau desktop; jika tidak, sulit untuk mengaitkan dampak operasi kontrol dengan elemen UI. Pengidentifikasi ini biasanya digunakan untuk Aksesibilitas saran otomatis. Jenis varian untuk penyedia: VT_UNKNOWN | VT_ARRAY Jenis varian untuk klien: VT_UNKNOWN (IUIAutomationElementArray ) Nilai default: array kosong |
|
Mengidentifikasi properti ControlType , yang merupakan kelas yang mengidentifikasi jenis elemen otomatisasi. ControlType mendefinisikan karakteristik elemen UI oleh primitif kontrol UI terkenal seperti tombol atau kotak centang. Jenis varian: VT_I4 Nilai default: UIA_CustomControlTypeId Catatan:
|
|
Mengidentifikasi properti Budaya, yang berisi pengidentifikasi lokal untuk elemen otomatisasi (misalnya, 0x0409 untuk "en-US" atau Inggris (Amerika Serikat)).Setiap lokal memiliki pengidentifikasi unik, nilai 32-bit yang terdiri dari pengidentifikasi bahasa dan pengidentifikasi urutan pengurutan. Pengidentifikasi lokal adalah singkatan numerik internasional standar dan memiliki komponen yang diperlukan untuk mengidentifikasi salah satu lokal yang ditentukan sistem operasi yang diinstal secara unik. Untuk informasi selengkapnya, lihat Konstanta dan String Pengidentifikasi Bahasa. Properti ini mungkin ada berdasarkan per kontrol, tetapi biasanya hanya tersedia pada tingkat aplikasi. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti DescribedBy , yang merupakan array elemen yang menyediakan informasi selengkapnya tentang elemen otomatisasi. DescribedBy digunakan saat elemen otomatisasi dijelaskan oleh segmen lain dari UI aplikasi. Misalnya, properti dapat menunjuk ke elemen teks "2.529 item dalam 85 grup, 10 item dipilih" dari objek daftar kustom yang kompleks. Alih-alih menggunakan model objek untuk klien untuk mencerna informasi serupa, properti DescribedBy dapat menawarkan akses cepat ke elemen UI yang mungkin sudah menawarkan informasi pengguna akhir yang berguna yang menjelaskan elemen UI. Jenis varian untuk penyedia: VT_UNKNOWN | VT_ARRAY Jenis varian untuk klien: VT_UNKNOWN (IUIAutomationElementArray) Nilai default: array kosong |
|
Mengidentifikasi properti FillColor , yang menentukan warna yang digunakan untuk mengisi elemen otomatisasi. Atribut ini ditentukan sebagai COLORREF, nilai 32-bit yang digunakan untuk menentukan warna RGB atau RGBA. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti FillType , yang menentukan pola yang digunakan untuk mengisi elemen otomatisasi, seperti tidak ada, warna, gradien, gambar, pola, dan sebagainya. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti FlowsFrom , yang merupakan array elemen otomatisasi yang menyarankan urutan baca sebelum elemen otomatisasi saat ini. Didukung dimulai dengan Windows 8. Properti FlowsFrom menentukan urutan pembacaan ketika elemen otomatisasi tidak diekspos atau disusun dalam urutan baca yang sama seperti yang dirasakan oleh pengguna. Meskipun properti FlowsFrom dapat menentukan beberapa elemen sebelumnya, biasanya hanya berisi elemen sebelumnya dalam urutan baca. Jenis varian untuk penyedia: VT_UNKNOWN | VT_ARRAY Jenis varian untuk klien: VT_UNKNOWN (IUIAutomationElementArray) Nilai default: array kosong |
|
Mengidentifikasi properti FlowsTo , yang merupakan array elemen otomatisasi yang menyarankan urutan baca setelah elemen otomatisasi saat ini. Properti FlowsTo menentukan urutan baca ketika elemen otomatisasi tidak diekspos atau disusun dalam urutan baca yang sama seperti yang dirasakan oleh pengguna. Meskipun properti FlowsTo dapat menentukan beberapa elemen yang berhasil, biasanya hanya berisi elemen berikutnya dalam urutan baca. Jenis varian untuk penyedia: VT_UNKNOWN | VT_ARRAY Jenis varian untuk klien: VT_UNKNOWN (IUIAutomationElementArray) Nilai default: array kosong |
|
Mengidentifikasi properti FrameworkId , yang merupakan string yang berisi nama kerangka kerja UI yang mendasar milik elemen automation. FrameworkId memungkinkan aplikasi klien memproses elemen otomatisasi secara berbeda tergantung pada kerangka kerja UI tertentu. Contoh nilai properti termasuk "Win32", "WinForm", dan "DirectUI". Jenis varian: VT_BSTR Nilai default: string kosong |
|
Properti FullDescription mengekspos string yang dilokalkan yang dapat berisi teks deskripsi yang diperluas untuk elemen. FullDescription dapat berisi deskripsi elemen yang lebih lengkap daripada yang mungkin sesuai untuk Nama elemen. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti HasKeyboardFocus , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi memiliki fokus keyboard. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti HeadingLevel , yang menunjukkan tingkat judul elemen Automation UI. Jenis varian: VT_I4 Nilai default: HeadingLevel_None |
|
Mengidentifikasi properti HelpText , yang merupakan string teks bantuan yang terkait dengan elemen otomatisasi. Properti HelpText dapat didukung dengan teks tempat penampung muncul di kontrol edit atau daftar. Misalnya, "Ketik teks di sini untuk pencarian" adalah kandidat yang baik properti HelpText untuk kontrol edit yang menempatkan teks sebelum input aktual pengguna. Namun, tidak memadai untuk properti nama kontrol edit. Ketika HelpText didukung, string harus cocok dengan bahasa UI aplikasi atau bahasa UI default sistem operasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti IsContentElement , yang merupakan nilai Boolean yang menentukan apakah elemen muncul dalam tampilan konten pohon elemen otomatisasi. Untuk informasi selengkapnya, lihat Gambaran Umum Pohon Otomatisasi UI. Catatan:
|
|
Mengidentifikasi properti IsControlElement , yang merupakan nilai Boolean yang menentukan apakah elemen muncul dalam tampilan kontrol pohon elemen otomatisasi. Untuk informasi selengkapnya, lihat Gambaran Umum Pohon Otomatisasi UI. Jenis varian: VT_BOOL Nilai default: TRUE |
|
Mengidentifikasi properti IsDataValidForForm , yang merupakan nilai Boolean yang menunjukkan apakah nilai yang dimasukkan atau dipilih valid untuk aturan formulir yang terkait dengan elemen otomatisasi. Misalnya, jika pengguna memasukkan "425-555-5555" untuk bidang kode pos yang memerlukan 5 atau 9 digit, properti IsDataValidForForm dapat diatur ke FALSE untuk menunjukkan bahwa data tidak valid. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsDialog , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi adalah jendela dialog. Misalnya, teknologi bantuan seperti pembaca layar biasanya berbicara judul dialog, kontrol terfokus dalam dialog, lalu konten dialog hingga kontrol yang difokuskan ("Anda ingin menyimpan perubahan Anda sebelum menutup"). Untuk jendela standar, pembaca layar biasanya mengucapkan judul jendela diikuti oleh kontrol yang difokuskan. Properti IsDialog dapat diatur ke TRUE untuk menunjukkan bahwa aplikasi klien harus memperlakukan elemen sebagai jendela dialog. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsEnabled , yang merupakan nilai Boolean yang menunjukkan apakah item UI yang direferensikan oleh elemen otomatisasi diaktifkan dan dapat berinteraksi. Ketika status kontrol yang diaktifkan adalah FALSE, diasumsikan bahwa kontrol anak juga tidak diaktifkan. Klien tidak boleh mengharapkan peristiwa yang diubah properti dari elemen anak ketika status kontrol induk berubah. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsKeyboardFocusable , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi dapat menerima fokus keyboard. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsOffscreen , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi sepenuhnya digulir keluar dari tampilan (misalnya, item dalam kotak daftar yang berada di luar viewport objek kontainer) atau diciutkan dari tampilan (misalnya, item dalam tampilan pohon atau menu, atau di jendela yang diminimalkan). Jika elemen memiliki titik yang dapat diklik yang dapat menyebabkannya menerima fokus, elemen dianggap di layar sementara sebagian elemen di luar layar. Nilai properti tidak dipengaruhi oleh oklusi oleh jendela lain, atau dengan apakah elemen terlihat pada monitor tertentu. Jika properti IsOffscreenTRUE, elemen UI digulir ke luar layar atau diciutkan. Elemen ini untuk sementara disembunyikan, namun tetap berada dalam persepsi pengguna akhir dan terus disertakan dalam model UI. Objek dapat dibawa kembali ke tampilan dengan menggulir, mengklik drop-down, dan sebagainya. Objek yang tidak dirasakan pengguna akhir sama sekali, atau yang "disembunyikan secara terprogram" (misalnya, kotak dialog yang telah dimatikan, tetapi objek yang mendasar masih di-cache oleh aplikasi) tidak boleh berada di pohon elemen otomatisasi di tempat pertama (alih-alih mengatur status IsOffscreen ke TRUE). Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsPassword , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi berisi konten atau kata sandi yang dilindungi. Ketika properti IsPasswordTRUE dan elemen memiliki fokus keyboard, aplikasi klien harus menonaktifkan gema keyboard atau umpan balik input keyboard yang dapat mengekspos informasi yang dilindungi pengguna. Mencoba mengakses properti Nilai dari elemen yang dilindungi (kontrol edit) dapat menyebabkan kesalahan terjadi. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti IsPeripheral , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi mewakili UI periferal. UI periferal muncul dan mendukung interaksi pengguna, tetapi tidak mengambil fokus keyboard saat muncul. Contoh UI periferal termasuk popup, flyout, menu konteks, atau pemberitahuan mengambang. Didukung dimulai dengan Windows 8.1. Ketika properti IsPeripheralTRUE, aplikasi klien tidak dapat mengasumsikan bahwa fokus diambil oleh elemen bahkan jika saat ini interaktif keyboard. Properti ini relevan untuk jenis kontrol ini:
Nilai default: FALSE |
|
Mengidentifikasi properti IsRequiredForForm , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi diperlukan untuk diisi pada formulir. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti ItemStatus , yang merupakan string teks yang menjelaskan status item elemen otomatisasi. ItemStatus memungkinkan klien untuk memastikan apakah elemen menyampaikan status tentang item serta statusnya. Misalnya, item yang terkait dengan kontak dalam aplikasi olahpesan mungkin "Sibuk" atau "Tersambung". Ketika ItemStatus didukung, string harus cocok dengan bahasa UI aplikasi atau bahasa UI default sistem operasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti ItemType , yang merupakan string teks yang menjelaskan jenis elemen otomatisasi. ItemType digunakan untuk mendapatkan informasi tentang item dalam daftar, tampilan pohon, atau kisi data. Misalnya, item dalam tampilan direktori file mungkin merupakan "File Dokumen" atau "Folder". Ketika ItemType didukung, string harus cocok dengan bahasa UI aplikasi atau bahasa antarmuka pengguna default sistem operasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti LabeledBy , yang merupakan elemen otomatisasi yang berisi label teks untuk elemen ini. Properti ini dapat digunakan untuk mengambil, misalnya, label teks statis untuk kotak kombo. Jenis varian: VT_UNKNOWN Nilai default: NULL |
|
Mengidentifikasi properti LandmarkType , yang merupakan Pengidentifikasi Jenis Tengara yang terkait dengan elemen . Properti LandmarkType menjelaskan elemen yang mewakili sekelompok elemen. Misalnya, landmark pencarian dapat mewakili sekumpulan kontrol terkait untuk pencarian. Jika UIA_CustomLandmarkTypeId digunakan, UIA_LocalizedLandmarkTypePropertyId diperlukan untuk menjelaskan landmark kustom. Jenis Varian: VT_I4 Nilai Default: 0 |
|
Mengidentifikasi properti Level , yang merupakan bilangan bulat berbasis 1 yang terkait dengan elemen otomatisasi. Properti Tingkat menjelaskan lokasi elemen di dalam struktur hierarkis atau rusak. Misalnya daftar berpoin/bernomor, judul, atau item data terstruktur lainnya dapat memiliki berbagai hubungan induk/anak. Tingkat menjelaskan di mana dalam struktur item berada. Disarankan untuk menggunakan Pola Kontrol CustomNavigation bersama dengan Level. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti LiveSetting , yang didukung oleh elemen otomatisasi yang mewakili wilayah langsung. Properti LiveSetting menunjukkan tingkat "sopan" yang harus digunakan klien untuk memberi tahu pengguna tentang perubahan pada wilayah langsung. Properti ini bisa menjadi salah satu nilai dari enumerasi LiveSetting . Didukung dimulai dengan Windows 8. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti LocalizedControlType , yang merupakan string teks yang menjelaskan jenis kontrol yang diwakili elemen otomatisasi. String hanya boleh berisi karakter huruf kecil:
Ketika LocalizedControlType tidak ditentukan oleh penyedia elemen, string lokal default disediakan oleh kerangka kerja, sesuai dengan jenis kontrol elemen (misalnya, "tombol" untuk jenis kontrol Tombol ). Elemen otomatisasi dengan jenis kontrol Kustom harus mendukung string jenis kontrol yang dilokalkan yang mewakili peran elemen (misalnya, "pemilih warna" untuk kontrol kustom yang memungkinkan pengguna memilih dan menentukan warna). Ketika nilai kustom disediakan, string harus cocok dengan bahasa UI aplikasi atau bahasa UI default sistem operasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi LocalizedLandmarkType, yang merupakan string teks yang menjelaskan jenis landmark yang diwakili elemen otomatisasi. Namun, ini harus digunakan bersama dengan UIA_CustomLandmarkTypeId , LocalizedLandmarkType harus selalu diutamakan daripada LandmarkType dan digunakan untuk menggambarkan landmark sebelum LandmarkType. String harus cocok dengan bahasa UI aplikasi atau bahasa antarmuka pengguna default sistem operasi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti Nama , yang merupakan string yang menyimpan nama elemen otomatisasi. Properti Nama harus sama dengan teks label di layar. Misalnya, Nama harus "Telusuri" untuk elemen tombol dengan label "Telusuri". Properti Nama tidak boleh menyertakan karakter mnemonic untuk kunci akses (yaitu, "&"), yang digaris bawahi dalam presentasi teks UI. Selain itu, properti Nama tidak boleh menjadi versi label di layar yang diperluas atau dimodifikasi karena ketidakkonsistensian antara nama dan label dapat menyebabkan kebingungan di antara aplikasi klien dan pengguna. Ketika teks label yang sesuai tidak terlihat di layar, atau ketika digantikan oleh grafik, teks alternatif harus dipilih. Teks alternatif harus ringkas, intuitif, dan dilokalkan ke bahasa UI aplikasi, atau ke bahasa UI default sistem operasi. Teks alternatif tidak boleh menjadi deskripsi terperinci tentang detail visual, tetapi deskripsi ringkas tentang fungsi atau fitur UI seolah-olah diberi label dengan teks sederhana. Misalnya, tombol menu Mulai Windows diberi nama "Mulai" (tombol) alih-alih "Logo Windows pada grafik bola bulat biru" (tombol). Untuk informasi selengkapnya, lihat Membuat Teks Yang Setara untuk Gambar. Saat label UI menggunakan grafik teks (misalnya, menggunakan ">>" untuk tombol yang menambahkan item dari kiri ke kanan), properti Nama harus ditimpa oleh alternatif teks yang sesuai (misalnya, "Tambahkan"). Namun praktik penggunaan grafik teks sebagai label UI tidak disarankan karena masalah pelokalan dan aksesibilitas. Properti Nama tidak boleh menyertakan peran kontrol atau informasi jenis, seperti "tombol" atau "daftar"; jika tidak, itu akan bertentangan dengan teks dari properti LocalizedControlType ketika kedua properti ini ditambahkan (banyak teknologi bantuan yang ada melakukan ini). Properti Nama tidak dapat digunakan sebagai pengidentifikasi unik di antara saudara kandung. Namun, selama konsisten dengan presentasi UI, nilai Nama yang sama dapat didukung di antara serekan. Untuk otomatisasi pengujian, klien harus mempertimbangkan untuk menggunakan properti AutomationId atau RuntimeId . Kontrol teks tidak selalu harus memiliki properti Nama yang identik dengan teks yang ditampilkan dalam kontrol, selama pola Teks juga didukung. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti NativeWindowHandle , yang merupakan bilangan bulat yang mewakili handel (HWND) dari jendela elemen otomatisasi, jika ada; jika tidak, properti ini adalah 0. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti OptimizeForVisualContent , yang merupakan nilai Boolean yang menunjukkan apakah penyedia hanya mengekspos elemen yang terlihat. Penyedia dapat menggunakan properti ini untuk mengoptimalkan performa saat bekerja dengan konten yang sangat besar. Misalnya, sebagai halaman pengguna melalui sebagian besar konten, penyedia dapat menghancurkan elemen konten yang tidak lagi terlihat. Ketika elemen konten dihancurkan, penyedia harus mengembalikan kode kesalahan UIA_E_ELEMENTNOTAVAILABLE . Didukung dimulai dengan Windows 8. Jenis varian: VT_BOOL Nilai default: FALSE |
|
Mengidentifikasi properti Orientasi , yang menunjukkan orientasi kontrol yang diwakili oleh elemen otomatisasi. Properti dinyatakan sebagai nilai dari jenis OrientationType yang dijumlahkan. Properti Orientasi didukung oleh kontrol, seperti bilah gulir dan slider, yang dapat memiliki orientasi vertikal atau horizontal. Jika tidak, itu selalu dapat OrientationType_None, yang berarti bahwa kontrol tidak memiliki orientasi. Jenis varian: VT_I4 Nilai default: 0 (OrientationType_None) |
|
Mengidentifikasi properti OutlineColor , yang menentukan warna yang digunakan untuk kerangka elemen otomatisasi. Atribut ini ditentukan sebagai COLORREF, nilai 32-bit yang digunakan untuk menentukan warna RGB atau RGBA. Jenis varian: VT_ARRAY VT_I4 | Nilai default: 0 |
|
Mengidentifikasi properti OutlineThickness , yang menentukan lebar untuk kerangka elemen otomatisasi. Jenis varian: VT_R8 | VT_ARRAY Nilai default: VT_EMPTY |
|
Mengidentifikasi properti PositionInSet , yang merupakan bilangan bulat berbasis 1 yang terkait dengan elemen otomatisasi. PositionInSet menjelaskan lokasi ordinal elemen dalam satu set elemen yang dianggap sebagai saudara kandung. PositionInSet bekerja berkoordinasi dengan properti SizeOfSet untuk menjelaskan lokasi ordinal dalam set. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti ProcessId , yang merupakan bilangan bulat yang mewakili pengidentifikasi proses (ID) elemen otomatisasi. Pengidentifikasi proses (ID) ditetapkan oleh sistem operasi. Ini dapat dilihat di kolom PID dari tab Proses di Task Manager. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti ProviderDescription , yang merupakan string berformat yang berisi informasi sumber penyedia Automation UI untuk elemen otomatisasi, termasuk informasi proksi. Jenis varian: VT_BSTR Nilai default: string kosong |
|
Mengidentifikasi properti Rotasi , yang menentukan sudut rotasi dalam unit yang tidak ditentukan. Jenis varian: VT_R8 Nilai default: 0 |
|
Mengidentifikasi properti RuntimeId , yang merupakan array bilangan bulat yang mewakili pengidentifikasi untuk elemen otomatisasi. Pengidentifikasi unik di desktop, tetapi dijamin unik hanya dalam UI desktop tempat pengidentifikasi dibuat. Pengidentifikasi dapat digunakan kembali dari waktu ke waktu. Format RuntimeId dapat berubah. Pengidentifikasi yang dikembalikan harus diperlakukan sebagai nilai buram dan hanya digunakan untuk perbandingan; misalnya, untuk menentukan apakah elemen otomatisasi berada di cache. Jenis varian: VT_ARRAY VT_I4 | Nilai default: VT_EMPTY |
|
Mengidentifikasi properti Ukuran , yang menentukan lebar dan tinggi elemen otomatisasi. Jenis varian: VT_R8 | VT_ARRAY Nilai default: VT_EMPTY |
|
Mengidentifikasi properti SizeOfSet , yang merupakan bilangan bulat berbasis 1 yang terkait dengan elemen otomatisasi. SizeOfSet menjelaskan jumlah elemen otomatisasi dalam grup atau set yang dianggap sebagai saudara kandung. SizeOfSet berfungsi dalam koordinasi dengan properti PositionInSet untuk menjelaskan jumlah item dalam set. Jenis varian: VT_I4 Nilai default: 0 |
|
Mengidentifikasi properti VisualEffects , yang merupakan bidang bit yang menentukan efek pada elemen otomatisasi, seperti bayangan, pantulan, cahaya, tepi lembut, atau kemiringan. VisualEffects:
Nilai default: 0 |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung |
Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Header |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk