Jenis Anotasi Dinamis

Ada tiga jenis Anotasi Dinamis yang didukung di Microsoft Active Accessibility: anotasi langsung, anotasi yang dipetakan nilai, dan anotasi server. Setiap jenis menawarkan keuntungan khusus, jadi penting untuk memahami perbedaannya.

Anotasi Langsung

Anotasi langsung adalah bentuk Anotasi Dinamis yang paling sederhana. Ini paling berlaku untuk elemen yang dapat diakses yang properti anotasinya tidak bergantung pada status kontrol dan tidak memerlukan dukungan tambahan yang disediakan oleh anotasi yang dipetakan nilai dan anotasi server. Anotasi langsung digunakan untuk mengambil alih nilai satu atau beberapa properti Aksesibilitas Aktif Microsoft dari elemen yang dapat diakses, dan untuk mengambil alih atau menambahkan properti Otomatisasi UI Microsoft ke kontrol. Semua anotasi yang dibuat dalam properti Aksesibilitas Aktif Microsoft tercermin dalam terjemahan Otomatisasi UI serta di proksi Otomatisasi Aksesibilitas Aktif ke UI Microsoft. Untuk informasi selengkapnya, lihat Anotasi Langsung.

Anotasi Peta Nilai

Selain secara langsung menganotasi properti IAccessible , sering kali ada kebutuhan untuk mengonversi nilai khusus kontrol menjadi string yang dapat dipahami oleh pengguna akhir. Contohnya adalah kontrol penggeser resolusi layar di bawah tab Pengaturan pada jendela Properti Tampilan (dari Panel Kontrol). Meskipun setiap posisi penggeser sesuai dengan resolusi yang berbeda (misalnya, 640 x 480, 1024 x 768), kontrol tidak memiliki pengetahuan tentang hubungan ini dan tidak dapat menyampaikan informasi ini ke Aksesibilitas Aktif Microsoft.

Anotasi yang dipetakan nilai membuat tugas ini lebih mudah. Dengan menggunakan bentuk anotasi ini, Anda dapat menentukan string untuk nilai penggeser dan menentukan peran, status, dan deskripsi untuk ikon dalam tampilan daftar dan pohon. Untuk informasi selengkapnya, lihat Anotasi Peta Nilai.

Anotasi Server

Anotasi server memungkinkan pengembang untuk mendaftarkan objek panggilan balik ke permintaan klien layanan untuk properti anotasi elemen. Objek panggilan balik ini harus mengimplementasikan antarmuka IAccPropServer dan didaftarkan dengan layanan anotasi Aksesibilitas Aktif Microsoft. Setelah terdaftar, akan diminta untuk melayani semua permintaan klien untuk nilai properti elemen yang dapat diakses tersebut.

Salah satu fitur anotasi server yang sangat berguna adalah bahwa server dapat didaftarkan sekali untuk menangani permintaan kontainer dan semua anaknya. Jadi, misalnya, satu server dapat disiapkan sekali untuk menangani permintaan untuk semua item adalah kotak daftar. Untuk informasi selengkapnya, lihat Anotasi Server.