Menambahkan Kontrol dan Teks

Kontrol dan teks yang ditempatkan pada kotak dialog dan billboard memungkinkan pengguna berinteraksi dengan proses penginstalan. Tambahkan kotak dialog ke antarmuka pengguna dengan menyertakannya dalam tabel Dialog seperti yang dijelaskan dalam Menggunakan Antarmuka Pengguna. Isi kotak dialog dan billboard dengan kontrol dengan mengisi tabel Kontrol dan tabel BBControl.

Atribut awal kontrol dapat ditentukan di kolom Atribut dari tabel Kontrol. Lihat Atribut Kontrol.

Untuk membuat atribut kontrol bergantung pada kondisi, gunakan tabel ControlCondition untuk menonaktifkan, mengaktifkan, menyembunyikan, atau menampilkan kontrol sesuai dengan nilai properti atau pernyataan bersyarat. Anda juga bisa menggunakan tabel ini untuk mengambil alih spesifikasi kontrol default yang dimasukkan ke dalam tabel Dialog.

Agar peristiwa mengubah atribut kontrol, berlangganan kontrol ke ControlEvent di tabel EventMapping. ControlEvent menentukan tindakan yang akan diambil oleh alat penginstal atau perubahan atribut dari satu atau beberapa kontrol dalam kotak dialog. Lihat Gambaran Umum ControlEvent. Masukkan pengidentifikasi atribut di kolom Atribut dan pengidentifikasi ControlEvent di kolom Peristiwa tabel EventMapping.

Beberapa kontrol memfasilitasi pengumpulan informasi dari pengguna. Misalnya, kotak centang memungkinkan pengguna untuk mengatur nilai properti. Lihat tabel Kotak Centang, tabel ComboBox, tabel ListBox, tabel RadioButton, dan tabel ListView.

Perhatikan bahwa untuk alasan keamanan, properti privat tidak dapat diubah oleh pengguna yang berinteraksi dengan antarmuka pengguna. Jika properti akan diatur oleh antarmuka pengguna, properti tersebut harus menjadi properti publik dan memiliki nama dalam semua huruf besar. Lihat Tentang Properti.

Anda dapat membuat kotak dialog Anda menyajikan informasi kepada pengguna atau menulisnya ke log sebagai respons terhadap tindakan penginstalan dengan mengisi tabel ActionText.

Kontrol dapat memiliki gaya font yang telah ditentukan sebelumnya. 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.

Disarankan agar properti DefaultUIFont dari setiap paket penginstalan dengan UI diatur dalam tabel Properti ke salah satu gaya yang telah ditentukan sebelumnya yang tercantum dalam tabel TextStyle. Jika properti ini tidak ditentukan, alat penginstal menggunakan font Sistem. Ini dapat menyebabkan alat penginstal menampilkan string teks dengan tidak benar jika halaman kode paket berbeda dari halaman kode UI default pengguna.

Untuk sebagian besar kontrol, teks ditampilkan menggunakan kumpulan karakter yang ditentukan oleh halaman kode database. Ini memastikan bahwa kumpulan karakter yang benar digunakan dengan informasi yang terkandung dalam database. Pengecualian untuk ini adalah kontrol Edit, DirectoryList, PathEdit, dan DirectoryCombo , yang selalu menampilkan teks menggunakan kumpulan karakter UI default pengguna. Kontrol Teks, ListBox, dan ComboBox menggunakan karakter UI default pengguna yang diatur jika Atribut Kontrol UsersLanguage diatur.

Dalam beberapa kasus, kontrol mungkin salah digambar ulang saat membatalkan dari kotak dialog. Ini berkaitan dengan urutan di mana kontrol menerima pesan WM_PAINT setelah kotak dialog Batal dihapus. Untuk memperbaikinya, coba ubah urutan kontrol dalam tabel Kontrol.

Kontrol harus dibuat cukup besar untuk mengakomodasi seluruh teks yang dilihat di semua pengaturan ukuran font. Kontrol harus dibuat cukup besar untuk mengakomodasi seluruh teks yang dilokalkan, jika teks di UI dapat dilokalkan. Ukuran font yang lebih besar atau teks yang dilokalkan dapat memerlukan lebih banyak ruang daripada teks asli dan dapat dipotok oleh kontrol yang dibuat terlalu kecil. Untuk informasi selengkapnya tentang melokalisasi teks antarmuka pengguna, lihat bagian: Contoh Pelokalan.