Bagikan melalui

Menerapkan Pola Kontrol Nilai Automasi UI

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 memperkenalkan panduan dan konvensi untuk menerapkan IValueProvider, termasuk informasi tentang peristiwa dan properti. Tautan ke referensi tambahan tercantum di akhir topik.

Pola ValuePattern kontrol digunakan untuk mendukung kontrol yang memiliki nilai intrinsik yang tidak mencakup rentang dan yang dapat direpresentasikan sebagai string. String ini dapat diedit, tergantung pada kontrol dan pengaturannya. Untuk contoh kontrol yang menerapkan pola ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Nilai, perhatikan panduan dan konvensi berikut:

  • Kontrol seperti ListItem dan TreeItem harus mendukung ValuePattern jika nilai salah satu item dapat diedit, terlepas dari mode edit kontrol saat ini. Kontrol induk juga harus mendukung ValuePattern jika item turunan dapat diedit.

Item daftar yang dapat diedit. Contoh Item Daftar yang Dapat Diedit

  • Kontrol edit baris tunggal mendukung akses terprogram ke kontennya dengan menerapkan IValueProvider. Namun, kontrol edit multibaris tidak menerapkan IValueProvider; sebaliknya, akses ke kontennya disediakan dengan menerapkan ITextProvider.

  • Untuk mengambil isi teks dari kontrol pengeditan multibaris, kontrol harus mengimplementasikan ITextProvider. Namun, ITextProvider tidak mendukung pengaturan nilai kontrol.

  • IValueProvider tidak mendukung pengambilan informasi pemformatan atau nilai substring. Terapkan ITextProvider dalam skenario ini.

  • IValueProvider harus diimplementasikan oleh kontrol seperti kontrol pemilihan Pemilih Warna dari Microsoft Word (diilustrasikan di bawah), yang mendukung pemetaan string antara nilai warna (misalnya, "kuning") dan struktur RGB internal yang setara.

Pemilih warna dengan sorotan warna kuning. Contoh Pemetaan String Sampel Warna

Anggota yang Diperlukan untuk IValueProvider

Properti dan metode berikut diperlukan untuk menerapkan IValueProvider.

Anggota yang diperlukan Jenis anggota Catatan
IsReadOnlyProperty Harta benda Tidak ada
ValueProperty Harta benda Tidak ada
SetValue Metode Tidak ada

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian Keadaan
InvalidOperationException SetValue

- Jika informasi khusus lokal diteruskan ke kontrol dalam format yang salah seperti tanggal yang salah diformat.
ArgumentException SetValue

- Jika nilai baru tidak dapat dikonversi dari string ke format yang dikenali kontrol.
ElementNotEnabledException SetValue

- Ketika upaya dilakukan untuk memanipulasi kontrol yang tidak diaktifkan.

Lihat juga

  • Last updated on