Edit Kontrol (Penginstal Windows)

Kontrol Edit adalah bidang edit yang terkait dengan properti nilai string atau bilangan bulat. Masukkan nama properti ke dalam kolom Properti dari tabel Kontrol.

Atribut Kontrol

Anda dapat menggunakan atribut berikut dengan kontrol ini. Untuk mengubah nilai atribut menggunakan peristiwa, berlangganan kontrol ke ControlEvent di tabel EventMapping dan cantumkan pengidentifikasi atribut di kolom Atribut. Masukkan pengidentifikasi ControlEvent di kolom Peristiwa.

Pengidentifikasi atribut Bit heksadesimal Deskripsi
IndirectPropertyName Ini adalah nama properti tidak langsung yang terkait dengan kontrol. Jika bit atribut Tidak Langsung diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Jika bit atribut Tidak Langsung diatur, nama ini juga merupakan nilai properti yang tercantum di kolom Properti dari tabel Kontrol.
Posisi Posisi kontrol dalam kotak dialog. Masukkan lebar, tinggi, dan koordinat kontrol sudut kiri kontrol ke kolom Lebar, Tinggi, X, dan Y tabel Kontrol. Gunakan unit alat penginstal untuk panjang dan jarak.
PropertyName Ini adalah nama properti yang terkait dengan kontrol ini. Jika bit atribut Tidak Langsung tidak diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Atribut ini ditentukan dalam kolom Properti dari tabel Kontrol.
PropertyValue Nilai properti saat ini ditampilkan atau diubah oleh kontrol ini. Jika bit atribut Tidak Langsung tidak diatur, ini adalah nilai PropertyName. Jika bit atribut Tidak Langsung diatur, ini adalah nilai IndirectPropertyName. Jika atribut berubah, kontrol mencerminkan nilai baru.
Teks Untuk mengatur font dan gaya font string teks, awali string karakter yang ditampilkan dengan {\style} atau {&style}. Di mana gaya adalah pengidentifikasi yang tercantum di kolom TextStyle dari tabel TextStyle. Jika tidak ada, tetapi properti DefaultUIFont didefinisikan sebagai gaya teks yang valid, font tersebut akan digunakan. Untuk menentukan jumlah karakter yang dapat dimasukkan pengguna, tambahkan {n} setelah spesifikasi font apa pun. Di mana n adalah bilangan bulat positif.
Dapat dilihat 0x00000000 0x00000001
Kontrol tersembunyi. Kontrol yang terlihat.
Sertakan bit ini dalam kata bit kolom Atribut dalam tabel Kontrol untuk membuat kontrol terlihat atau tersembunyi pada pembuatannya.
Anda juga dapat menyembunyikan atau memperlihatkan kontrol dengan menggunakan tabel ControlCondition.
Diaktifkan 0x00000000 0x00000002
Kontrol dalam status dinonaktifkan. Kontrol dalam status diaktifkan.
Sertakan bit ini dalam kata bit di kolom Atribut Kontrol untuk mengaktifkan kontrol pada pembuatan.
Anda juga dapat mengaktifkan atau menonaktifkan kontrol dengan menggunakan tabel ControlCondition.
Cekung 0x00000000 0x00000004
Menampilkan gaya visual default. Menampilkan kontrol dengan tampilan tenggelam, 3-D.
Sertakan bit ini dalam kata bit di kolom Atribut dari tabel Kontrol.
Langsung 0x00000000 0x00000008
Kontrol menampilkan atau mengubah nilai properti di kolom Properti dari tabel Kontrol. Kontrol menampilkan atau mengubah nilai properti yang memiliki Pengidentifikasi yang tercantum di kolom Properti dari tabel Kontrol.
Menentukan apakah properti yang terkait dengan kontrol ini dirujuk secara tidak langsung.
Bilangan bulat 0x00000000 0x00000010
Properti yang terkait dengan kontrol adalah nilai string. Properti yang terkait dengan kontrol adalah nilai bilangan bulat.
Sertakan bit ini dalam kata bit dari kolom Atribut tabel Kontrol untuk mengatur atribut ini pada pembuatan kontrol.
RTLRO 0x00000000 0x00000020
Teks dalam kontrol ditampilkan dalam urutan pembacaan kiri-ke-kanan. Teks dalam kontrol ditampilkan dalam urutan baca kanan-ke-kiri.
RightAligned 0x00000000 0x00000040
Teks dalam kontrol diratakan ke kiri. Teks dalam kontrol diratakan ke kanan.
LeftScroll 0x00000000 0x00000080
Bilah gulir terletak di sisi kanan kontrol. Bilah gulir terletak di sisi kiri kontrol.
BiDi 0x000000E0 Atur nilai ini untuk kombinasi atribut RTLRO, RightAligned, dan LeftScroll .
Multiline 0x00010000 Membuat kontrol edit beberapa baris dengan bilah gulir vertikal. Sertakan 65536 dalam kata bit di kolom Atribut Kontrol untuk membuat kontrol edit beberapa baris dengan bilah gulir vertikal.
Password 0x00200000 Membuat kontrol edit untuk memasukkan kata sandi. Tambahkan 2097152 ke nilai di kolom Atribut tabel Kontrol untuk membuat kontrol edit yang menampilkan setiap karakter sebagai tanda bintang (*) saat diketik ke dalam kontrol. Mengatur Atribut Kata Sandi mencegah penginstal menulis properti yang terkait dengan kontrol Edit ke dalam file log. Untuk informasi selengkapnya, lihat Mencegah Informasi Rahasia Ditulis ke dalam File Log

Keterangan

Kontrol ini dapat dibuat dari kelas EDIT dengan menggunakan fungsi CreateWindowEx. Ini memiliki gaya WS_BORDER, WS_CHILD, WS_TABSTOP, dan WS_GROUP .

Panjang teks yang dapat dimasukkan dapat dibatasi dengan meletakkan angka dari 0 hingga 2147483646 dalam kurung kurawal di awal bidang Teks dalam tabel Kontrol. Misalnya, jika bidang teks dimulai dengan {80}, panjang string dibatasi pada 80 karakter. Jika tidak ada batas yang diberikan dalam tabel, atau jika 0 ditentukan, panjangnya diatur ke maksimum yang mungkin (2147483646 karakter). Nilai negatif atau non-numerik akan menghasilkan kesalahan.

Untuk kompatibilitas dengan pembaca layar, saat menulis kotak dialog dengan kontrol Edit sebagai kontrol aktif pertama, Anda harus menjadikan bidang teks milik bidang edit sebagai kontrol aktif pertama dalam tabel Dialog. Karena teks statis tidak dapat mengambil fokus, ketika kotak dialog dibuat, bidang edit akan memiliki fokus awalnya seperti yang dimaksudkan, tetapi melakukan ini memastikan bahwa pembaca layar menampilkan informasi yang benar.

Properti yang terkait dengan kontrol Edit hanya diatur ketika kontrol kehilangan fokus. Oleh karena itu, Anda harus mem-tab dari kontrol atau memilih kontrol yang berbeda untuk properti yang akan diperbarui.