Kontrol Tampilan Daftar
Kontrol ListView yang menampilkan satu kolom nilai dengan ikon di samping setiap item. Ini memungkinkan pengguna untuk memilih satu string atau nilai bilangan bulat untuk properti dari daftar yang telah ditentukan. Nilai yang mungkin dibaca dari tabel ListView. Anda dapat mengaitkan kontrol dengan nilai bilangan bulat atau string dengan memasukkan nama properti ke dalam kolom Properti dari tabel Kontrol.
Konten bidang Teks dari tabel Kontrol tidak pernah ditampilkan oleh kontrol ListView. Sebaliknya, bidang ini menentukan gaya teks yang akan ditampilkan oleh kontrol dan berisi deskripsi kontrol yang digunakan oleh utilitas tinjauan layar. 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. Informasi berikut ini dibaca oleh utilitas ulasan layar sebagai deskripsi kontrol. Lihat Aksesibilitas.
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 menampilkan teks dalam pembaca layar, masukkan teks ke dalam kolom Teks tabel Kontrol. Lihat Aksesibilitas. | |
| 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 . |
| Diurutkan | 0x00000000 0x00010000 |
Item ditampilkan dalam urutan alfabet. Item ditampilkan dalam urutan yang ditentukan dalam tabel ListView. Sertakan bit ini dalam kata bit di kolom Atribut untuk menampilkan item dalam urutan yang ditentukan oleh kolom Urutan tabel ListView. |
| FixedSize | 0x00000000 0x00100000 |
Membentangkan gambar ikon agar pas dengan kontrol. Memangkas atau memanjangkan gambar ikon dalam kontrol. Sertakan bit ini dalam kata bit kolom Atribut dari tabel Kontrol. |
| Ukuran Ikon | 0x00000000 0x00200000 0x00400000 0x00600000 |
Memuat gambar pertama. Memuat gambar 16x16 pertama. Memuat gambar 32x32 pertama. Memuat gambar 48x48 pertama. File ikon dapat berisi gambar ukuran yang berbeda dari ikon yang sama. Sertakan nilai kata bit yang sesuai di kolom Atribut dari tabel Kontrol Jika bit ini tidak diatur, alat penginstal mengabaikan atribut FixedSize dan gambar direntangkan agar sesuai dengan persegi kontrol. Jika bit IconSize dan bit FixedSize diatur, gambar yang lebih kecil dari kontrol dipusatkan dan gambar lebih besar dari kontrol yang dikecilkan agar pas. |
Keterangan
Kontrol ini dapat dibuat dari kelas WC_LISTVIEW dengan menggunakan fungsi CreateWindowEx. Ini memiliki gaya LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDER, dan WS_TABSTOP . Jika bit gaya Diurutkan tidak aktif, kontrol juga memiliki gaya LVS_SORTASCENDING .
Untuk kompatibilitas dengan pembaca layar, saat menulis dialog dengan kontrol ListView sebagai kontrol aktif pertama, Anda harus membuat bidang teks milik bidang edit kontrol aktif pertama dalam tabel Dialog. Karena teks statis tidak dapat mengambil fokus, ketika dialog dibuat, bidang edit akan memiliki fokus awalnya seperti yang dimaksudkan, tetapi melakukan ini memastikan bahwa pembaca layar menampilkan informasi yang benar.