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 Control dan tabel BBControl, masing-masing.

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 dapat menggunakan tabel ini untuk mengambil alih spesifikasi kontrol default yang dimasukkan ke dalam tabel Dialog .

Untuk membuat sebuah peristiwa mengubah atribut kontrol, berlangganan kontrol ke ControlEvent di tabel EventMapping. ControlEvent menentukan tindakan yang akan diambil oleh alat penginstal atau perubahan atribut satu atau beberapa kontrol dalam kotak dialog. Lihat Gambaran Umum ControlEvent. Masukkan ID atribut di kolom Atribut dan ID ControlEvent di kolom Event pada 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 perlu 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 tabel TextStyle. Jika tidak ada dari keduanya yang ada, tetapi properti DefaultUIFont didefinisikan sebagai gaya teks yang valid, maka font tersebut akan digunakan.

Disarankan agar propertiDefaultUIFont dari setiap paket penginstalan dengan UI diatur dalam tabel Properti ke salah satu gaya yang telah ditentukan yang tercantum dalam tabel TextStyle. Jika properti ini tidak ditentukan, alat penginstal menggunakan font Sistem. Ini dapat menyebabkan alat penginstal menampilkan string teks secara 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 Text, ListBox, dan ComboBox menggunakan karakter set UI default pengguna jika Atribut Kontrol UsersLanguage diatur.

Dalam beberapa kasus, kontrol mungkin digambar ulang secara tidak benar saat membatalkan kotak dialog. Ini ada hubungannya dengan urutan kontrol menerima pesan WM_PAINT setelah kotak dialog Batalkan 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 dipotong oleh kontrol yang dibuat terlalu kecil. Untuk informasi selengkapnya tentang melokalisasi teks UI, lihat bagian: Contoh Pelokalan.