Bagikan melalui

Edit Kontrol (Referensi Elemen UI MSAA)

  • Artikel

Catatan

Topik ini menjelaskan objek Edit Kontrol untuk tujuan Referensi Elemen UI MSAA. Cara membuat objek Edit Kontrol di berbagai kerangka kerja UI tidak dijelaskan di sini. Lihat dokumentasi referensi API untuk kerangka kerja UI yang Anda gunakan.

Edit kontrol memungkinkan pengguna melihat dan mengedit teks. Kontrol edit dibuat dengan berbagai gaya seperti ES_MULTILINE. Gaya ini membuat kontrol edit multibaris, seperti area klien Notepad, dan ES_READONLY, yang membuat kontrol edit baca-saja.

Microsoft Active Accessibility tidak membuat perbedaan antara kontrol edit yang dibuat dengan nama kelas jendela "EDIT" dan kontrol edit kaya yang dibuat dengan nama kelas jendela "RichEdit" atau "RichEdit20A".

Metode IAccessible

Kontrol edit mendukung metode IAccessible berikut:

Properti IAccessible

Kontrol edit mendukung properti IAccessible berikut:

Properti Komentar
get_accChild
get_accChildCount
get_accDescription
get_accFocus
get_accKeyboardShortcut Properti KeyboardShortcut adalah tombol akses kontrol edit, yang merupakan karakter bergaris bawah dalam teks label kontrol edit. Misalnya, pada kotak dialog Buka File standar seperti di WordPad, KeyboardShortcut untuk kontrol edit berlabel "NamaFile:" adalah "Alt+n".
get_accName Properti Nama adalah teks dari kontrol teks statis yang melabeli kontrol edit. Misalnya, pada kotak dialog Buka File standar seperti di WordPad, properti Nama untuk kontrol edit adalah "Nama file:".
get_accParent Properti Induk adalah jendela ( ROLE_SYSTEM_WINDOW ) yang mengelilingi kontrol dan memiliki properti Nama dan nama kelas jendela yang sama dengan kontrol.
get_accRole Properti PeranROLE_SYSTEM_TEXT.
get_accSelection
get_accState Properti Status adalah kombinasi dari satu atau beberapa nilai berikut ini:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL
get_accValue Properti Nilai adalah string tunggal yang berisi teks dalam kontrol edit. Namun, jika kontrol dilindungi kata sandi, properti Nilai mengembalikan E_ACCESSDENIED. Untuk kontrol pengeditan multibaris, string berisi pengembalian gerbong dan karakter baris baru di akhir setiap baris.

Catatan

  • Microsoft Active Accessibility tidak mendukung pilihan teks yang terkandung dalam kontrol edit dan pengeditan kaya karena teks diekspos sebagai string di properti Nilai objek.

  • Kontrol edit kaya yang disediakan oleh Riched20.dll (yang digunakan dalam editor teks seperti WordPad di Windows 98) tidak mengirim WinEvents apa pun ketika posisi tanda sisipan diubah selama pemilihan teks. Saat pengguna menekan tombol SHIFT dan panah untuk memilih teks, objek tanda sisipan tidak memicu EVENT_OBJECT_LOCATIONCHANGE WinEvent. Ketika pilihan diatur secara terprogram melalui pesan edit yang kaya, objek caret tidak mengirim peristiwa apa pun untuk menunjukkan posisi barunya.

    Semua aplikasi yang menggunakan Riched20.dll menunjukkan masalah ini. Aplikasi yang menggunakan versi sebelumnya dari kontrol edit kaya mengirim peristiwa dengan benar berdasarkan pilihan.

  • Nilai Status untuk kontrol pengeditan kata sandi selalu menyertakan bendera bit STATE_SYSTEM_PROTECTED.

Antarmuka IAccessible