Kontrol DirectoryList
Kontrol DirectoryList menampilkan bagian dari jalur yang saat ini ditampilkan di kontrol PathEdit. Kontrol DirectoryList menampilkan folder di bawah direktori yang saat ini ditampilkan oleh kontrol DirectoryCombo.
Kontrol PathEdit, DirectoryCombo, dan DirectoryList dikaitkan dengan properti bernilai string yang sama. Properti tersebut adalah jalur yang dipilih oleh pengguna. Masukkan nama properti ke dalam kolom Properti dari tabel Kontrol . Properti ini harus memiliki nilai awal yang berisi setidaknya satu volume dan satu sublevel. Tentukan nilai awal untuk properti di kolom Nilai tabel Properti .
Kontrol ini dimaksudkan untuk digunakan pada Telusuri Dialog bersama dengan PathEdit dan kontrol DirectoryList.
Kontrol DirectoryList menerbitkan ControlEvents berikut.
| ControlEvent | Deskripsi |
|---|---|
| DirectoryList | Membuat folder baru dan memilih bidang nama untuk pengeditan. |
| IgnoreChange | Sorotan, tetapi tidak terbuka, folder di direktori saat ini. |
| DirectoryListUp | Memilih induk direktori saat ini. |
| DirectoryListBuka | Memilih dan menyoroti direktori. |
Konten bidang Teks dari tabel Kontrol tidak pernah ditampilkan oleh kontrol DirectoryList. 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 tabel TextStyle. Jika tidak ada, tetapi propertiDefaultUIFont 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 dari 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. | |
| Terlihat | 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 menampilkan 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. |
| Sunken | 0x00000000 0x00000004 |
Menampilkan gaya visual default. Menampilkan kontrol dengan tenggelam, 3D, lihat. Sertakan bit ini dalam kata bit di kolom Atribut tabel kontrol . |
| tidak 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. |
| 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. |
| Kontrol BiDi | 0x000000E0 | Tetapkan nilai ini untuk kombinasi RTLRO , RightAligned , dan atribut LeftScroll. |
Komentar
Kontrol ini dapat dibuat dari kelas WC_LISTVIEW dengan menggunakan fungsiCreateWindowEx. Ini memiliki LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP, dan gaya WS_TABSTOP.
Kontrol ini memungkinkan pengguna memilih subfolder pilihan saat ini. Dengan tombol tambahan, ini juga memungkinkan pengguna memilih folder baru dalam pilihan saat ini atau meningkatkan satu tingkat di jalur. Jika pengguna memilih tombol Buat Folder Baru di folder tempat folder baru sudah ada, folder baru kedua tidak dibuat dan nama folder baru yang sudah ada dipilih untuk pengeditan.