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 dari tabel Properti.

Kontrol ini dimaksudkan untuk digunakan pada Dialog Telusuri bersama dengan kontrol PathEdit dan DirectoryList.

Kontrol DirectoryList menerbitkan ControlEvents berikut.

ControlEvent Deskripsi
DirectoryListNew 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.
DirectoryListOpen 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 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 tenggelam, 3D, lihat.
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.
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 Atur nilai ini untuk kombinasi atribut RTLRO, RightAligned, dan LeftScroll .

Keterangan

Kontrol ini dapat dibuat dari kelas WC_LISTVIEW dengan menggunakan fungsi CreateWindowEx. 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.