Share via

Pola Kontrol Nilai

  • Artikel

Menjelaskan panduan dan konvensi untuk menerapkan IValueProvider, termasuk informasi tentang properti dan metode. Pola kontrol Nilai digunakan untuk mendukung kontrol yang memiliki nilai intrinsik yang tidak mencakup rentang dan yang dapat direpresentasikan sebagai string.

String nilai dapat diedit, tergantung pada kontrol dan pengaturannya. Untuk contoh kontrol yang mengimplementasikan pola kontrol ini, lihat Jenis Kontrol dan Pola Kontrol yang Didukung.

Topik ini berisi bagian berikut.

Panduan dan Konvensi Implementasi

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

  • Kontrol seperti item daftar atau item pohon harus mendukung pola kontrol Nilai jika nilai salah satu item dapat diedit, terlepas dari mode edit kontrol saat ini. Kontrol induk juga harus mendukung pola kontrol Nilai jika item anak dapat diedit. Gambar berikut ini memperlihatkan contoh item daftar yang dapat diedit.

    ilustrasi memperlihatkan item daftar yang dapat diedit

  • Kontrol edit tunggal dan multibaris harus mengimplementasikan ITextProvider untuk mengekspos konten baca-saja.

  • Kontrol edit multibaris harus mengimplementasikan IValueProvider jika kontennya dapat diubah.

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

  • IValueProvider harus diimplementasikan oleh kontrol seperti kontrol pemilih warna dari Microsoft Word (lihat gambar berikut), yang mendukung pemetaan string antara nilai warna (misalnya, "kuning") dan nilai RGB internal yang setara.

    ilustrasi memperlihatkan pemetaan string swatch warna

  • Kontrol harus mengatur properti IsEnabled ke TRUE dan properti ITextProvider::IsReadOnly diatur ke FALSE sebelum mengizinkan panggilan ke ITextProvider::SetValue.

Anggota yang Diperlukan untuk IValueProvider

Properti dan metode berikut diperlukan untuk mengimplementasikan antarmuka IValueProvider .

Anggota yang diperlukan Jenis anggota Catatan
IsReadOnly Properti Tidak ada
Nilai Properti Tidak ada
SetValue Metode Tidak ada

 

Pola kontrol ini tidak memiliki peristiwa terkait.

Jenis Kontrol dan Pola Kontrol yang Didukung

Gambaran Umum Pola Kontrol UI Automation

Gambaran Umum Pohon UI Automation

Pola Kontrol Text dan TextRange