AutomationProperties Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan dukungan untuk mendapatkan atau mengatur nilai properti otomatisasi tingkat instans. Nilai properti ini ditetapkan sebagai properti terlampir (biasanya di XAML) dan melengkapi atau mengambil alih nilai properti otomatisasi dari AutomationPeer kontrol.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationPropertiesPublic NotInheritable Class AutomationProperties- Warisan
- Atribut
Keterangan
Properti terlampir XAML
AutomationProperties adalah kelas layanan host untuk beberapa properti terlampir XAML. Tujuan dari properti terlampir ini adalah untuk mengaktifkan pengaturan berbagai nilai per instans yang berkaitan dengan bagaimana elemen UI dilaporkan ke kerangka kerja aksesibilitas Microsoft UI Automation. Ini berguna dalam kasus di mana desain kelas elemen UI belum meneruskan nilai properti terkait UI lainnya sebagai bagian dari integrasi Microsoft UI Automation atau perilaku implementasi serekan, atau di mana nilai yang diteruskan bukan nilai yang ingin Anda laporkan ke Microsoft UI Automation.
Untuk mendukung akses prosesor XAML ke properti terlampir, dan juga untuk mengekspos operasi dapatkan dan atur yang setara ke kode, setiap properti terlampir XAML memiliki sepasang metode aksesor Get and Set , yang juga merupakan anggota AutomationProperties. Misalnya, metode GetName dan SetName mendukung dan memberikan dukungan khusus kode yang setara untuk melaporkan nilai Nama otomatisasi ke Otomatisasi UI Microsoft, alih-alih menggunakan properti Terlampir Nama untuk mengaturnya di XAML. Atau, Anda dapat menggunakan sistem properti dependensi untuk mendapatkan atau mengatur nilai properti terlampir, dan ini juga melaporkan nilai yang mendasar ke Microsoft UI Automation. Panggil GetValue atau SetValue, meneruskan argumen pengidentifikasi properti dependensi untuk diatur, dan referensi ke objek target untuk mendapatkan atau mengatur nilai.
Properti nama
Dari berbagai properti terlampir, mungkin yang paling penting adalah Nama. Ini karena ini adalah properti Nama yang paling sering diakses dan dilaporkan oleh teknologi bantuan ketika pengguna berinteraksi dengan aplikasi dalam skenario aksesibilitas. Nama berfungsi sebagai pengidentifikasi yang dapat dibaca manusia untuk elemen UI.
Berbagai elemen UI memiliki penerusan peer yang dapat memberikan nilai Nama default berdasarkan properti elemen lainnya. Misalnya, penerusan serekan untuk kelas Tombol akan meneruskan evaluasi ToString dari konten Tombol dan menggunakan string ini sebagai Nama default. Untuk mengambil alih default tersebut, atau untuk memberikan nilai Nama untuk setiap kasus elemen UI di mana tidak ada Nama Otomatisasi UI Microsoft yang tersedia, atur properti Terlampir nama pada elemen tersebut di XAML. Untuk informasi selengkapnya tentang mengapa Nama Otomatisasi UI Microsoft penting, lihat Informasi aksesibilitas dasar. Untuk informasi selengkapnya tentang cara menguji apakah elemen sudah memiliki Nama yang disediakan serekan yang berguna, lihat Pengujian aksesibilitas.
Untuk alasan pelokalan, Anda harus menghindari nilai string yang dikodekan secara permanen untuk Nama di XAML. Jika Anda mengatur direktif x:Uid pada elemen , maka Anda dapat menggunakan sumber daya RESW untuk menargetkan properti dan memberikan nilai yang berbeda untuk pelokalan. Untuk properti terlampir, formulir pengidentifikasi sumber daya memerlukan kualifikasi penuh properti terlampir dalam formulir XAML, termasuk namespace layanannya dan menggunakan: awalan. Misalnya, untuk menargetkan nilai properti terlampir AutomationProperties.Name pada sumber daya yang memiliki nilai direktif x:Uid "sendButton", nilai nama item data dalam sumber daya RESW adalah sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Properti terlampir
Catatan
Untuk informasi selengkapnya tentang setiap properti terlampir, lihat halaman untuk bidang Pengidentifikasi properti.
| Properti terlampir | Deskripsi |
|---|---|
| AcceleratorKey | Mendapatkan atau mengatur kunci akselerator untuk elemen yang ditentukan.
|
| AccessibilityView | Mendapatkan atau mengatur mode tampilan pohon Microsoft UI Automation untuk elemen. |
| AccessKey | Mendapatkan atau mengatur kunci akses untuk elemen yang ditentukan.
|
| AutomationId | Mendapatkan atau mengatur string yang secara unik mengidentifikasi elemen ke Microsoft UI Automation.
|
| Kultur | Mendapatkan atau mengatur pengidentifikasi lokal untuk elemen otomatisasi (misalnya, 0x0409 untuk "en-US" atau English (Amerika Serikat)).
|
| FullDescription | Mendapatkan atau mengatur string yang dilokalkan yang berisi teks deskripsi yang diperluas untuk elemen.
|
| JudulLevel | Mendapatkan atau mengatur tingkat judul untuk elemen Automation UI.
|
| HelpText | Mendapatkan atau mengatur teks bantuan untuk elemen .
|
| IsDataValidForForm | Mendapatkan atau menetapkan nilai yang menunjukkan apakah data valid untuk formulir.
|
| IsDialog | Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen otomatisasi adalah jendela dialog.
|
| IsPeripheral | Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen otomatisasi mewakili UI periferal.
|
| IsRequiredForForm | Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen diperlukan untuk diisi pada formulir.
|
| ItemStatus | Mendapatkan atau mengatur deskripsi status item dalam elemen.
|
| ItemType | Mendapatkan atau mengatur deskripsi jenis elemen yang ditentukan.
|
| LabeledBy | Mendapatkan atau mengatur elemen yang berisi label teks untuk elemen .
|
| LandmarkType | Mendapatkan atau mengatur Pengidentifikasi Jenis Tengara yang terkait dengan elemen.
|
| Tingkat | Mendapatkan atau mengatur bilangan bulat berbasis 1 yang menjelaskan lokasi elemen di dalam struktur hierarkis atau rusak.
|
| LiveSetting | Mendapatkan atau mengatur nilai pengaturan langsung untuk elemen yang ditentukan.
|
| LocalizedControlType | Mendapatkan atau mengatur string teks yang dilokalkan yang menjelaskan jenis kontrol yang diwakili elemen automasi.
|
| LocalizedLandmarkType | Mendapatkan atau mengatur string teks yang dilokalkan yang menjelaskan jenis tengara yang diwakili elemen automasi.
|
| Nama | Mendapatkan atau mengatur nama Automasi UI dari elemen .
|
| PositionInSet | Mendapatkan atau menetapkan bilangan bulat berbasis 1 yang menjelaskan lokasi ordinal elemen dalam satu set elemen yang dianggap sebagai saudara kandung.
|
| SizeOfSet | Mendapatkan atau mengatur jumlah elemen dalam sekumpulan elemen yang dianggap sebagai saudara kandung.
|
Properti
| AcceleratorKeyProperty |
Mengidentifikasi properti terpasang AutomationProperties.AcceleratorKey , yang merupakan string yang berisi kombinasi kunci akselerator (juga disebut kunci pintasan) untuk elemen otomatisasi. |
| AccessibilityViewProperty |
Mengidentifikasi properti terlampir AutomationProperties.AccessibilityView . Atur properti terlampir ini pada elemen individual untuk mengubah visibilitas elemen mereka ke mode tertentu yang diminta oleh klien Automation UI. |
| AccessKeyProperty |
Mengidentifikasi properti terlampir AutomationProperties.AccessKey , yang merupakan string yang berisi karakter kunci akses untuk elemen otomatisasi. |
| AnnotationsProperty |
Mengidentifikasi properti dependensi yang digunakan untuk daftar objek anotasi dalam dokumen, seperti komentar, header, footer, dan sebagainya. |
| AutomationControlTypeProperty |
AutomationProperties Mengidentifikasi properti terlampir, yang merupakan Microsoft.UI.Xaml.Automation.Peers.AutomationControlType. |
| AutomationIdProperty |
Mengidentifikasi properti terlampir AutomationProperties.AutomationId , yang merupakan string yang berisi pengidentifikasi Otomatisasi UI (ID) untuk elemen otomatisasi. |
| ControlledPeersProperty |
Mengidentifikasi properti terlampir ControlledPeers, yang digunakan untuk kumpulan elemen otomatisasi yang dapat dimanipulasi oleh elemen otomatisasi yang ditentukan. |
| CultureProperty |
Mendapatkan pengidentifikasi untuk properti terlampir budaya yang berisi pengidentifikasi lokal untuk elemen otomatisasi (misalnya, 0x0409 untuk "en-US" atau Inggris (Amerika Serikat)). |
| DescribedByProperty |
Mendapatkan pengidentifikasi untuk properti yang dijelaskan oleh properti terlampir, yang merupakan array elemen yang memberikan informasi selengkapnya tentang elemen otomatisasi. |
| FlowsFromProperty |
Mendapatkan pengidentifikasi untuk properti FlowsFrom terlampir, yang merupakan array elemen otomatisasi yang menyarankan urutan pembacaan sebelum elemen otomatisasi saat ini. |
| FlowsToProperty |
Mendapatkan pengidentifikasi untuk properti terlampir FlowsTo , yang merupakan array elemen otomatisasi yang menyarankan urutan baca setelah elemen otomatisasi saat ini. |
| FullDescriptionProperty |
Mendapatkan pengidentifikasi untuk properti terlampir deskripsi lengkap, yang mengekspos string yang dilokalkan yang berisi teks deskripsi yang diperluas untuk elemen. |
| HeadingLevelProperty |
Mendapatkan pengidentifikasi untuk properti terlampir HeadingLevel , yang menunjukkan tingkat judul untuk elemen Automation UI. |
| HelpTextProperty |
Mengidentifikasi properti terlampir AutomationProperties.HelpText , yang merupakan string teks bantuan yang terkait dengan elemen otomatisasi. |
| IsDataValidForFormProperty |
Mengidentifikasi properti dependensi Boolean yang menunjukkan apakah data valid untuk formulir. |
| IsDialogProperty |
Mengidentifikasi properti terlampir AutomationProperties.IsDialog , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi adalah jendela dialog. |
| IsPeripheralProperty |
Mengidentifikasi properti dependensi Boolean yang menunjukkan apakah elemen otomatisasi mewakili UI periferal. |
| IsRequiredForFormProperty |
Mengidentifikasi properti terlampir AutomationProperties.IsRequiredForForm , yang merupakan nilai Boolean yang menunjukkan apakah elemen otomatisasi diperlukan untuk diisi pada formulir. |
| ItemStatusProperty |
Mengidentifikasi properti terlampir ItemStatus, yang menjelaskan status item elemen otomatisasi. |
| ItemTypeProperty |
Mengidentifikasi properti terlampir AutomationProperties.ItemType , yang merupakan string teks yang menjelaskan jenis elemen otomatisasi. |
| LabeledByProperty |
Mengidentifikasi properti terlampir AutomationProperties.LabeledBy , yang merupakan elemen otomatisasi yang berisi label teks untuk elemen ini. |
| LandmarkTypeProperty |
Mendapatkan pengidentifikasi untuk properti terlampir jenis landmark, yang merupakan Pengidentifikasi Jenis Tengara yang terkait dengan elemen. |
| LevelProperty |
Mendapatkan pengidentifikasi untuk properti Terlampir Tingkat , yang merupakan bilangan bulat berbasis 1 yang terkait dengan elemen otomatisasi. |
| LiveSettingProperty |
Mengidentifikasi properti terlampir AutomationProperties.LiveSetting , yang didukung oleh elemen otomatisasi yang mewakili wilayah langsung. |
| LocalizedControlTypeProperty |
Mengidentifikasi properti dependensi jenis kontrol yang dilokalkan, yang merupakan string teks yang menjelaskan jenis kontrol yang diwakili elemen otomatisasi. |
| LocalizedLandmarkTypeProperty |
Mendapatkan pengidentifikasi untuk properti terlampir jenis landmark yang dilokalkan, yang merupakan string teks yang dilokalkan yang menjelaskan jenis tengara yang diwakili elemen automasi. |
| NameProperty |
Mengidentifikasi properti terlampir AutomationProperties.Name , yang merupakan string yang menyimpan nama elemen otomatisasi. |
| PositionInSetProperty |
Mendapatkan pengidentifikasi untuk properti terlampir PositionInSet , yang merupakan bilangan bulat berbasis 1 yang terkait dengan elemen otomatisasi. |
| SizeOfSetProperty |
Mendapatkan pengidentifikasi untuk properti terlampir. |
Properti yang Terlampir
| AcceleratorKey |
Mendapatkan atau mengatur string yang berisi kombinasi tombol akselerator (juga disebut tombol pintasan) untuk elemen otomatisasi. |
| AccessibilityView |
Mendapatkan atau mengatur mode tampilan pohon Otomatisasi UI Microsoft untuk elemen . |
| AccessKey |
Mendapatkan atau mengatur string yang berisi karakter kunci akses untuk elemen otomatisasi. |
| Annotations |
Mendapatkan daftar objek anotasi dalam dokumen, seperti komentar, header, footer, dan sebagainya. |
| AutomationControlType |
Mengidentifikasi jenis elemen antarmuka pengguna (UI) yang diekspos ke klien Microsoft UI Automation. |
| AutomationId |
Mendapatkan atau mengatur string yang secara unik mengidentifikasi elemen ke Microsoft UI Automation. |
| ControlledPeers |
Mendapatkan kumpulan elemen otomatisasi yang dapat dimanipulasi oleh elemen otomatisasi yang ditentukan. |
| Culture |
Mendapatkan atau mengatur pengidentifikasi lokal untuk elemen otomatisasi (misalnya, 0x0409 untuk "en-US" atau Inggris (Amerika Serikat)). |
| DescribedBy |
Mendapatkan array elemen yang memberikan informasi selengkapnya tentang elemen otomatisasi. |
| FlowsFrom |
Mendapatkan array elemen otomatisasi yang menyarankan urutan baca sebelum elemen otomatisasi saat ini. |
| FlowsTo |
Mendapatkan array elemen otomatisasi yang menyarankan urutan pembacaan setelah elemen otomatisasi saat ini. |
| FullDescription |
Mendapatkan atau mengatur string yang dilokalkan yang berisi teks deskripsi yang diperluas untuk elemen. |
| HeadingLevel |
Mendapatkan atau mengatur tingkat judul untuk elemen Automation UI. |
| HelpText |
Mendapatkan atau mengatur string teks bantuan yang terkait dengan elemen otomatisasi. |
| IsDataValidForForm |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah data valid untuk formulir. |
| IsDialog |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen otomatisasi adalah jendela dialog. |
| IsPeripheral |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen otomatisasi mewakili UI periferal. |
| IsRequiredForForm |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen diperlukan untuk diisi pada formulir. |
| ItemStatus |
Mendapatkan atau mengatur deskripsi status item dalam elemen. |
| ItemType |
Mendapatkan atau mengatur deskripsi jenis elemen yang ditentukan. |
| LabeledBy |
Mendapatkan atau mengatur elemen otomatisasi yang berisi label teks untuk elemen ini. |
| LandmarkType |
Mendapatkan atau mengatur Pengidentifikasi Jenis Tengara yang terkait dengan elemen. |
| Level |
Mendapatkan atau mengatur bilangan bulat berbasis 1 yang menjelaskan lokasi elemen di dalam struktur hierarkis atau rusak. |
| LiveSetting |
Mendapatkan atau mengatur nilai pengaturan langsung untuk elemen yang ditentukan, yang didukung oleh elemen otomatisasi yang mewakili wilayah langsung. |
| LocalizedControlType |
Mendapatkan atau mengatur string teks yang dilokalkan yang menjelaskan jenis kontrol yang diwakili elemen automasi. |
| LocalizedLandmarkType |
Mendapatkan atau mengatur string teks yang dilokalkan yang menjelaskan jenis tengara yang diwakili elemen automasi. |
| Name |
Mendapatkan atau mengatur nama Automasi UI dari elemen . |
| PositionInSet |
Mendapatkan atau menetapkan bilangan bulat berbasis 1 yang menjelaskan lokasi ordinal elemen dalam satu set elemen yang dianggap sebagai saudara kandung. |
| SizeOfSet |
Mendapatkan atau mengatur jumlah elemen dalam sekumpulan elemen yang dianggap sebagai saudara kandung. |
Metode
Berlaku untuk
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