Kontrol Daftar
Kontrol Daftar yang tercakup pada seksi ini semuanya diturunkan secara langsung atau tidak langsung dari TListControl. Oleh karena itu akan berbagi set properti yang sama dan umum dipakai, termasuk,
- Items - daftar item dalam kontrol. Item adalah tipe TListItem. Daftar item bisa dipopulasikan melalui penyatuan data atau ditetapkan dalam template seperti berikut:
<com:TListBox>
<com:TListItem Text="text 1" Value="value 1" />
<com:TListItem Text="text 2" Value="value 2" Selected="true" />
<com:TListItem Text="text 3" Value="value 3" />
</com:TListBox>
- SelectedIndex - indeks berbasis-nol pada item yang dipilih dalam daftar item.
- SelectedIndices - indeks dari semua item yang dipilih.
- SelectedItem - item yang pertama dipilih dalam daftar item.
- SelectedValue - nilai dari item pertama yang dipilih dalam daftar item.
- AutoPostBack - apakah perubahan pilihan pada kontrol memicu postback atau tidak.
- CausesValidation - apakah validasi harus dilakukan saat postback dipicu oleh kontrol daftar.
Karena TListControl berasal dari TDataBoundControl, kontrol daftar ini juga berbagi operasi umum yang sama yang dikenal sebagai databinding atau penyatuan data. Items dapat dipopulasikan dari data yang sudah ada dan ditetapkan oleh DataSource atau DataSourceID. Fungsi yang memanggil dataBind() akan menyebabkan populasi data. Untuk kontrol daftar, data bisa ditetapkan dalam dua jenis format berikut:
- array satu-dimensi atau obyek yang mengimplementasikan ITraversable : kunci array akan dipakai sebagai nilai item daftar, dan nilai array akan dipakai sebagai teks item daftar. Sebagai contoh
$listbox->DataSource=array(
'key 1'=>'item 1',
'key 2'=>'item 2',
'key 3'=>'item 3');
$listbox->dataBind();
- data tabular (dua-dimensi): setiap baris mempopulasi satu item daftar. Nilai item daftar ditetapkan oleh anggota yang diindeks dengan DataValueField, dan teks item daftar dengan DataTextField. Sebagai contoh,
$listbox->DataTextField='name';
$listbox->DataValueField='id';
$listbox->DataSource=array(
array('id'=>'001','name'=>'John','age'=>31),
array('id'=>'002','name'=>'Mary','age'=>30),
array('id'=>'003','name'=>'Cary','age'=>20));
$listbox->dataBind();
TListBox
TListBox menampilkan kotak daftar yang membolehkan satu atau multipel pilihan. Setel properti SelectionMode sebagai Single untuk menjadikan kotak daftar pilihan tunggal, dan Multiple untuk kotak daftar pilihan multipel. Jumlah baris ditampilkan dalam kotak ditetapkan melalui nilai properti Rows.
TDropDownList
TDropDownList menampilkan kotak daftar dropdown yang membolehkan pengguna untuk memilih opsi tunggal dari beberapa yang telah ditetapkan.
Sejak v3.1.1, TDropDownList mulai mendukung teks pertanyaan (seperti 'Please select:' sebagai item list pertama). Untuk menggunakan fitur ini, setel baik PromptText ataupun PromptValue, atau keduanya. Jika pengguna memilih item pertanyaan, dropdown list tidak akan dipilih.
TCheckBoxList
TCheckBoxList menampilkan sebuah daftar kotak centang pada halaman Web. Penjajaran teks selain setiap kotak centang dapat ditetapkan dengan TextAlign. Tata letak kotak centang bisa dikontrol oleh properti berikut:
- RepeatLayout - berupa Table atau Flow. Table menggunakan sel tabel HTML untuk mengatur kotak centang, sementara Flow mengunakan tag span dan break HTML untuk pengaturannya. Dengan tata letak Table, anda bisa menyetel CellPadding dan CellSpacing.
- RepeatColumns - berapa banyak kolom kotak centang akan ditampilkan.
- RepeatDirection - ke mana menjelajahi kotak centang, dalam cara horisontal (karena kotak centang ditampilkan dalam tata letak mirip-matriks).
TRadioButtonList
TRadioButtonList mirip dengan TCheckBoxList dalam setiap aspek kecuali bahwa setiap TRadioButtonList menampilkan sebuah grup tombol radio. Hanya satu tombol radio dapat dipilih, (TCheckBoxList membolehkan pilihan multipel).
TBulletedList
TBulletedList menampilkan item dalam format bulat pada halaman Web. Gaya bulat dapat ditetapkan dengan BulletStyle. Ketika gaya adalah CustomImage, tanda bulat ditampilkan sebagai gambar, yang ditetapkan dengan BulletImageUrl.
TBulletedList menampilkan teks item dalam tiga mode berbeda,
- Text - teks item ditampilkan sebagai teks statis;
- HyperLink - setiap item ditampilkan sebagai hiperlink yang URL-nya diberikan oleh nilai item, dan properti Target bisa dipakai untuk menetapkan jendela browser;
- LinkButton - setiap item ditampilkan sebagai tombol link yang melakukan posts back pada halaman jika pengguna mengkliknya, dan event OnClick akan dimunculkan di bawah keadaan demikian.