Anotasi Peta Nilai
Dengan anotasi peta nilai, Anda dapat menggunakan string pemetaan untuk menunjukkan bagaimana indeks gambar item dalam tampilan daftar atau tampilan pohon sesuai dengan peran atau statusnya. Misalnya, string pemetaan dapat menunjukkan bahwa indeks gambar tampilan daftar 0 memetakan ke peran kotak centang, sementara indeks gambar 1 memetakan ke peran tombol radio.
Anda juga dapat menggunakan anotasi peta nilai untuk menentukan untai (karakter) yang memetakan ke nilai numerik pada pengganda.
Kapan Menggunakan Teknik Ini
Pertimbangkan untuk menggunakan Anotasi Peta Nilai dalam situasi berikut.
Saat tampilan daftar yang digambar pemilik atau tampilan pohon menggabungkan penggunaan gambar, dan Anda ingin memberikan deskripsi kustom yang dapat diakses (properti Deskripsi ) berdasarkan gambar tersebut. Ilustrasi berikut ini memperlihatkan contoh.
Saat tampilan daftar yang digambar pemilik atau kontrol tampilan pohon menggabungkan penggunaan gambar untuk membuat item pohon atau daftar bertindak seperti kontrol sederhana, biasanya kotak centang atau tombol radio, dan Anda ingin memetakan gambar ke peran. Cuplikan layar berikut menunjukkan contoh.
Saat penggeser digunakan untuk memilih nilai yang dapat digambarkan sebagai sesuatu selain bilangan bulat sederhana, seperti pada cuplikan layar berikut, di mana pengaturan resolusi layar dijelaskan oleh string.
Dengan anotasi peta nilai, string pemetaan menunjukkan bagaimana indeks gambar daftar atau pohon sesuai dengan peran atau statusnya. Atau, ini dapat menunjukkan bagaimana nilai numerik penggeser sesuai dengan string. Misalnya, string pemetaan dapat menunjukkan bahwa indeks gambar tampilan daftar 0 memetakan ke peran kotak centang dan indeks gambar 1 peta ke peran tombol radio. Gunakan IAccPropServices::SetHwndPropStr() untuk melampirkan string pemetaan ke kontrol.
Karena pengetahuan khusus kontrol diperlukan untuk mendukung pemetaan nilai, ada sejumlah kontrol dan properti terbatas yang mendukung anotasi peta nilai, termasuk peta nilai penggeser, tampilan daftar, dan tampilan pohon.
Peta Nilai Penggerak
PROPID_ACC_VALUEMAP berisi pemetaan dari posisi penggeser internal ke string yang dapat dibaca manusia. Properti ini didukung oleh proksi penggerak Oleacc.dll. Jika nilai penggeser saat ini ditemukan di peta nilai, string yang sesuai akan diekspos sebagai nilai alih-alih string persentase default (misalnya, "50").
Tampilan Daftar dan Tampilan Pohon
PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAP, dan PROPID_ACC_DESCRIPTONMAP menyediakan pemetaan dari indeks gambar status ke nilai peran dan status. Peta ini memungkinkan indeks gambar tersebut dipetakan ke peran yang sesuai (biasanya ROLE_SYSTEM_RADIOBUTTON atau ROLE_SYSTEM_CHECKBUTTON) dan bit status tambahan (biasanya STATE_SYSTEM_CHECKED).
Untuk informasi selengkapnya tentang anotasi peta nilai, lihat topik berikut ini:
Format Peta Anotasi
Tabel berikut ini menjelaskan bidang yang disertakan dalam peta anotasi.
| Bidang | Deskripsi |
|---|---|
| 'A' | Menunjukkan bahwa skema pengkodian tertentu digunakan. Awalan tambahan dapat didukung untuk skema pengodean di masa mendatang. |
| Karakter pemisah | Biasanya titik dua (:) digunakan, tetapi dapat menjadi karakter lain kecuali untuk NULL atau spasi kosong. Karena karakter ini akan digunakan sebagai pemisah untuk bidang yang tersisa, karakter ini mungkin tidak digunakan sebagai bagian dari nilai dalam peta. |
| 0, 1 atau 2 | Nilai yang menunjukkan kunci mana yang sedang digunakan. Untuk peta peran dan status Tampilan Pohon dan Tampilan Daftar, kunci ini bisa 0 (indeks gambar), 1 (indeks gambar status), atau 2 (indeks gambar overlay). Untuk penggerak dan kontrol lain yang tidak menawarkan pilihan kunci, nilai ini harus 0. |
| Karakter pemisah | : |
| Pasangan kunci-nilai | Setiap pasangan terdiri dari string kunci dan karakter pemisah. String kunci adalah angka dan mungkin dalam format desimal atau heksadesimal (dengan awalan "0x" terkemuka). |
| String nilai | Untuk peta nilai, ini adalah string. Untuk peta peran dan status, ini adalah angka (desimal atau heksadesimal). |
| Karakter pemisah | : |
Misalnya, peta mungkin terlihat seperti berikut ini:
A:0:0:Cold:1:Warm:3:Hot:
Ketika peta nilai ini diterapkan ke kontrol slider, nilai "Hangat" akan diekspos ketika penggukser berada di posisi 1. Karena nilai 2 tidak disertakan dalam contoh ini, nilai default untuk posisi tersebut akan diekspos. Untuk penggerak, defaultnya adalah nilai persentase, seperti 33.