Kontrol SelectionTree
Kontrol ini memungkinkan pengguna mengubah status pilihan fitur yang tercantum dalam tabel Fitur. Kontrol dikaitkan dengan properti bernilai string yang dapat diatur pengguna oleh dialog Telusuri. Anda dapat mengaitkan kontrol dengan properti dengan memasukkan nama properti di kolom Properti dari tabel Kontrol.
Kontrol SelectionTree secara otomatis menerbitkan Peristiwa Kontrol berikut pada Windows XP atau sistem operasi sebelumnya. Kontrol SelectionTree menerbitkan peristiwa ini saat item yang dipilih diubah dari satu simpul ke simpul lainnya. Jika pohon pilihan tidak memiliki simpul, kontrol menerbitkan peristiwa ini dan menghapus konten kontrol yang berlangganan peristiwa. ControlEvents ini tidak diperlukan untuk dicantumkan dalam tabel ControlEvent.
| Peristiwa kontrol | Deskripsi |
|---|---|
| SelectionAction | Menerbitkan string dari tabel UIText yang menjelaskan item yang disorot. |
| SelectionBrowse | Menghasilkan kotak dialog Telusuri yang digunakan untuk mengubah jalur item yang disorot. |
| SelectionDescription | Menerbitkan string dari tabel Fitur yang menjelaskan item yang disorot. |
| SelectionNoItems | Menghapus teks deskriptif atau menonaktifkan tombol item usang. |
| SelectionPath | Menerbitkan jalur untuk item yang disorot. |
| SelectionPathOn | Menerbitkan apakah ada jalur pilihan yang terkait dengan fitur yang saat ini dipilih. |
| Ukuran Pilihan | Menerbitkan ukuran item yang disorot. |
Dimulai dengan sistem Windows Server 2003, kontrol SelectionTree menerbitkan semua peristiwa dalam tabel di atas, dan sebagai tambahan, menerbitkan DoAction ControlEvent atau SetProperty ControlEvent. Rekaman harus ditambahkan ke tabel ControlEvent untuk menerbitkan DoAction atau SetProperty ControlEvents.
| Peristiwa kontrol | Deskripsi |
|---|---|
| DoAction | Memberi tahu alat penginstal untuk menjalankan tindakan kustom. |
| SetProperty | Mengatur properti ke nilai baru. |
Dimulai dengan Penginstal Windows versi 3.0, kontrol SelectionTree menerbitkan peristiwa yang menjalankan tindakan kustom yang tercantum dalam tabel ControlEvent. Kontrol SelectionTree menerbitkan peristiwa ini setiap kali pilihan fitur berubah dalam kontrol atau setiap kali status pilihan yang berbeda dipilih untuk fitur saat ini. Tindakan kustom berjalan setiap kali peristiwa diterbitkan. Kontrol SelectionTree mengirimkan informasi ke tindakan kustom dengan mengatur nilai properti berikut. Semua properti ini semuanya dibersihkan ketika kontrol SelectionTree ditutup.
Windows Installer 2.0: Tidak didukung. Kontrol SelectionTree tidak menerbitkan peristiwa dan tidak mengatur properti berikut.
| Properti | Deskripsi |
|---|---|
| MsiSelectionTreeSelectedFeature | Nama fitur yang dipilih di bidang Fitur dari tabel Fitur. |
| MsiSelectionTreeSelectedAction | Status tindakan penginstalan fitur yang dipilih. Nilainya mungkin INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE, atau INSTALLSTATE_ADVERTISED. |
| MsiSelectonTreeChildrenCount | Jumlah simpul anak langsung. |
| MsiSelectionTreeInstallingChildrenCount | Jumlah simpul anak langsung yang INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE, atau INSTALLSTATE_ADVERTISED. |
| MsiSelectionTreeSelectedCost | Biaya penginstalan fitur yang dipilih dalam unit 512 byte. |
| MsiSelectionTreeChildrenCost | Biaya menginstal semua fitur anak dalam unit 512 byte. |
| MsiSelectionTreeSelectedPath | Jalur tempat fitur yang dipilih sedang diinstal. Ditentukan hanya jika fitur sedang diinstal sebagai INSTALLSTATE_LOCAL. |
Catatan
Konten bidang Teks dari tabel Kontrol tidak pernah ditampilkan oleh kontrol SelectionTree. 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 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 | 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 | 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 | Menampilkan teks dalam screenreaders sesuai dengan teks yang dimasukkan 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. |
| BiDi | 0x000000E0 | Atur nilai ini untuk kombinasi atribut RTLRO, RightAligned, dan LeftScroll . |
Keterangan
Kontrol ini dapat dibuat dari kelas WC_TREEVIEW dengan menggunakan fungsi CreateWindowEx. Ini memiliki gaya WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOP, dan WS_GROUP .
Pohon pilihan hanya diisi jika tindakan CostInitialize dan tindakan CostFinalize telah dipanggil.
String berikut dalam tabel UIText terkait dengan kontrol ini.
| Persyaratan | Deskripsi |
|---|---|
| AbsentPath |
Jalur ditampilkan untuk item dalam status tidak ada. |
Enam string berikut digunakan untuk menampilkan jumlah anak yang dipilih dan ukuran yang terkait dengan item yang disorot:
- SelChildCostPos
- SelChildCostNeg
- SelParentCostPosPos
- SelParentCostPosNeg
- SelParentCostNegPos
- SelParentCostNegNeg
String berikut digunakan untuk menampilkan opsi pilihan yang tersedia untuk item di menu popup:
- MenuAbsent
- MenuLokal
- MenuCD
- MenuNetwork
- MenuAllLocal
- MenuSemuaCD
- MenuAllNetwork
String berikut digunakan untuk menjelaskan pilihan saat ini di SelectionDescription ControlEvent.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Empat string yang dilokalkan berikut digunakan dalam memformat ukuran file:
- Byte
- KB
- MB
- GB
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk