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 tingkat instans properti otomatisasi. Nilai properti ini ditetapkan sebagai properti terlampir (biasanya dalam XAML) dan melengkapi atau menimpa nilai properti otomatisasi dari AutomationPeer kontrol.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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
Persyaratan Windows
| Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Tip
Buka aplikasi Galeri WinUI 3 dan lihat prinsip Aksesibilitas berikut ini dalam tindakan:
Aplikasi WinUI 3 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub
Keterangan
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
Lihat Properti terlampir untuk daftar lengkap (untuk informasi selengkapnya tentang setiap properti terlampir, lihat bidang Pengidentifikasi setiap properti).
Riwayat versi
| Versi Windows | Versi SDK | Nilai ditambahkan |
|---|---|---|
| 1511 | 10586 | GetLandmarkType |
| 1511 | 10586 | GetLocalizedLandmarkType |
| 1511 | 10586 | SetLandmarkType |
| 1511 | 10586 | SetLocalizedLandmarkType |
| 1607 | 14393 | GetDescribedBy |
| 1607 | 14393 | GetFlowsFrom |
| 1607 | 14393 | GetFlowsTo |
| 1607 | 14393 | GetFullDescription |
| 1607 | 14393 | GetIsDataValidForForm |
| 1607 | 14393 | GetIsPeripheral |
| 1607 | 14393 | GetLocalizedControlType |
| 1607 | 14393 | SetFullDescription |
| 1607 | 14393 | SetIsDataValidForForm |
| 1607 | 14393 | SetIsPeripheral |
| 1607 | 14393 | SetLocalizedControlType |
| 1703 | 15063 | GetCulture |
| 1703 | 15063 | SetCulture |
| 1803 | 17134 | GetHeadingLevel |
| 1803 | 17134 | SetHeadingLevel |
| 1809 | 17763 | GetIsDialog |
| 1809 | 17763 | SetIsDialog |
Properti
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 Microsoft UI Automation 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 |
Mendapatkan atau mengatur jenis kontrol untuk 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 English (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 baca 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 otomatisasi. |
| LocalizedLandmarkType |
Mendapatkan atau mengatur string teks yang dilokalkan yang menjelaskan jenis tengara yang diwakili elemen otomatisasi. |
| Name |
Mendapatkan atau mengatur nama Automation 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. |