Bagikan melalui

pesan TVM_SELECTITEM

  • Artikel

Memilih item tampilan pohon yang ditentukan, menggulir item ke tampilan, atau menggambar ulang item dalam gaya yang digunakan untuk menunjukkan target operasi seret dan letakkan. Anda bisa mengirim pesan ini secara eksplisit atau dengan menggunakan makro TreeView_Select, TreeView_SelectItem, atau TreeView_SelectDropTarget .

Parameter

wParam

Bendera tindakan. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai Makna
TVGN_CARET
 Menyetel pilihan ke item yang ditentukan. Jendela induk kontrol tampilan pohon menerima kode pemberitahuan TVN_SELCHANGING dan TVN_SELCHANGED .
TVGN_DROPHILITE
 Menggambar ulang item yang ditentukan dalam gaya yang digunakan untuk menunjukkan target operasi seret dan letakkan.
TVGN_FIRSTVISIBLE
 Memastikan bahwa item yang ditentukan terlihat, dan, jika memungkinkan, menampilkannya di bagian atas jendela kontrol. Kontrol tampilan pohon menampilkan item sebanyak yang akan pas di jendela. Jika item yang ditentukan berada di dekat bagian bawah hierarki item kontrol, item tersebut mungkin tidak menjadi item pertama yang terlihat, tergantung pada berapa banyak item yang pas di jendela.
TVSI_NOSINGLEEXPAND
 Saat satu item dipilih, pastikan bahwa tampilan pohon tidak memperluas turunan item tersebut. Ini hanya valid jika digunakan dengan bendera TVGN_CARET.
Catatan: Untuk menggunakan bendera ini, Anda harus menyediakan manifes yang menentukan Comclt32.dll versi 6.0. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

lParam

Menangani ke item. Jika lParamADALAH NULL, kontrol diatur agar tidak memiliki item yang dipilih.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Keterangan

Jika item yang ditentukan adalah anak dari item induk yang diciutkan, daftar item anak induk diperluas untuk mengungkapkan item yang ditentukan. Dalam hal ini, jendela induk kontrol menerima kode pemberitahuan TVN_ITEMEXPANDING dan TVN_ITEMEXPANDED .

Menggunakan makro TreeView_SelectItem setara dengan mengirim pesan TVM_SELECTITEM dengan wParam diatur ke nilai TVGN_CARET. Menggunakan makro TreeView_SelectDropTarget setara dengan mengirim pesan TVM_SELECTITEM dengan wParam diatur ke nilai TVGN_DROPHILITE. Menggunakan TreeView_SelectSetFirstVisible setara dengan mengirim pesan TVM_SELECTITEM dengan wParam diatur ke nilai TVGN_FIRSTVISIBLE.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
Header
Commctrl.h