Kelas CMFCShellTreeCtrl
Kelas CMFCShellTreeCtrl
memperluas fungsionalitas Kelas CTreeCtrl dengan menampilkan hierarki item Shell.
Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.
Sintaks
class CMFCShellTreeCtrl : public CTreeCtrl
Anggota
Metode Publik
Nama | Deskripsi |
---|---|
CMFCShellTreeCtrl::EnableShellContextMenu | Mengaktifkan atau menonaktifkan menu pintasan. |
CMFCShellTreeCtrl::GetFlags | Mengembalikan kombinasi bendera yang diteruskan ke IShellFolder::EnumObjects. |
CMFCShellTreeCtrl::GetItemPath | Mengambil jalur ke item. |
CMFCShellTreeCtrl::GetRelatedList | Mengembalikan penunjuk ke objek Kelas CMFCShellListCtrl yang digunakan bersama dengan objek ini CMFCShellTreeCtrl untuk membuat jendela seperti Explorer. |
CMFCShellTreeCtrl::OnChildNotify | Fungsi anggota ini dipanggil oleh jendela induk jendela ini ketika menerima pesan pemberitahuan yang berlaku untuk jendela ini. (Penimpaan CWnd::OnChildNotify.) |
CMFCShellTreeCtrl::OnGetItemIcon | |
CMFCShellTreeCtrl::OnGetItemText | |
CMFCShellTreeCtrl::Refresh | Menyegarkan dan mengecat ulang objek saat ini CMFCShellTreeCtrl . |
CMFCShellTreeCtrl::SelectPath | Memilih item kontrol pohon yang sesuai berdasarkan PIDL atau jalur string yang disediakan. |
CMFCShellTreeCtrl::SetFlags | Mengatur bendera untuk memfilter konteks pohon (mirip dengan bendera yang digunakan oleh IShellFolder::EnumObjects ). |
CMFCShellTreeCtrl::SetRelatedList | Mengatur hubungan antara objek saat ini CMFCShellTreeCtrl dan CMFCShellListCtrl objek. |
Keterangan
Kelas ini memperluas CTreeCtrl
kelas dengan mengaktifkan program Anda untuk menyertakan item Windows Shell di pohon. Kelas ini dapat dikaitkan dengan CMFCShellListCtrl
objek untuk membuat jendela Explorer lengkap. Kemudian, memilih item di pohon akan menampilkan daftar item Windows Shell dalam daftar terkait.
Hierarki Warisan
CMFCShellTreeCtrl
Persyaratan
Header: afxshelltreeCtrl.h
Contoh
Contoh berikut menunjukkan cara membuat objek CMFCShellTreeCtrl
kelas. Cuplikan kode ini adalah bagian dari sampel Explorer.
CMFCShellTreeCtrl m_wndShellTree;
// const int idTree = 1
CRect rectDummy(0, 0, 0, 0);
const DWORD dwViewStyle = WS_CHILD | WS_VISIBLE | TVS_HASLINES |
TVS_LINESATROOT | TVS_HASBUTTONS;
// The this pointer points to CFolderBar class which extends the CDockablePane class
m_wndShellTree.Create(dwViewStyle, rectDummy, this, idTree);
CMFCShellTreeCtrl::EnableShellContextMenu
Mengaktifkan menu pintasan.
void EnableShellContextMenu(BOOL bEnable = TRUE);
Parameter
bEnable
[di] Boolean yang menentukan apakah akan mengaktifkan menu pintasan.
CMFCShellTreeCtrl::GetFlags
Mengembalikan bendera yang ditetapkan untuk objek Kelas CMFCShellTreeCtrl.
DWORD GetFlags() const;
Tampilkan Nilai
Nilai DWORD yang menentukan kombinasi bendera yang saat ini ditetapkan.
Keterangan
Bendera yang diatur dalam CMFCShellTreeCtrl
dikirim ke metode IShellFolder::EnumObjects setiap kali objek di-refresh. Anda dapat mengubah bendera dengan metode CMFCShellTreeCtrl::SetFlags .
CMFCShellTreeCtrl::GetItemPath
Mengambil jalur item di objek Kelas CMFCShellTreeCtrl.
BOOL GetItemPath(
CString& strPath,
HTREEITEM htreeItem = NULL) const;
Parameter
strPath
[out] Referensi ke parameter string. Metode menulis jalur item ke parameter ini.
htreeItem
[di] Metode mengambil jalur untuk item kontrol pohon ini.
Tampilkan Nilai
Bukan nol jika berhasil; 0 jika tidak.
Keterangan
Jika metode ini gagal, strPath berisi string kosong.
Jika Anda tidak menentukan hTreeItem, metode ini mencoba untuk mendapatkan string untuk item yang saat ini dipilih. Jika tidak ada item yang dipilih dan hTreeItem adalah NULL, metode ini gagal.
CMFCShellTreeCtrl::GetRelatedList
Mengembalikan penunjuk ke objek Kelas CMFCShellListCtrl yang terkait dengan objek CMFCShellTreeCtrl ini.
CMFCShellListCtrl* GetRelatedList() const;
Tampilkan Nilai
Penunjuk ke CMFCShellListCtrl
objek yang terkait dengan objek kontrol pohon ini.
Keterangan
Dengan menggunakan CMFCShellListCtrl
objek bersama dengan CMFCShellTreeCtrl
objek, Anda dapat membuat jendela seperti Explorer. Gunakan metode CMFCShellTreeCtrl::SetRelatedList untuk mengaitkan dua kelas. Setelah dikaitkan, kerangka kerja secara otomatis memperbarui CMFCShellListCtrl
jika pilihan dalam CMFCShellTreeCtrl
perubahan.
CMFCShellTreeCtrl::OnChildNotify
virtual BOOL OnChildNotify(
UINT message,
WPARAM wParam,
LPARAM lParam,
LRESULT* pLResult);
Parameter
[di] pesan
[di] wParam
[di] lParam
[di] pLResult
Tampilkan Nilai
Keterangan
CMFCShellTreeCtrl::OnGetItemIcon
virtual int OnGetItemIcon(
LPAFX_SHELLITEMINFO pItem,
BOOL bSelected);
Parameter
[di] pItem
[di] bPilih
Tampilkan Nilai
Keterangan
CMFCShellTreeCtrl::OnGetItemText
virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);
Parameter
[di] pItem
Tampilkan Nilai
Keterangan
CMFCShellTreeCtrl::Refresh
Merefresh dan mengecat ulang CMFCShellTreeCtrl.
void Refresh();
Keterangan
Panggil metode ini untuk menyegarkan hierarki item yang ditampilkan di CMFCShellTreeCtrl
.
CMFCShellTreeCtrl::SelectPath
Memilih item di Kelas CMFCShellTreeCtrl berdasarkan jalur yang disediakan.
BOOL SelectPath(LPCTSTR lpszPath);
BOOL SelectPath(LPCITEMIDLIST lpidl);
Parameter
lpszPath
[di] String yang menentukan jalur item.
lpidl
[di] PIDL yang menentukan item
Tampilkan Nilai
S_OK jika berhasil; E_FAIL sebaliknya.
CMFCShellTreeCtrl::SetFlags
Mengatur bendera untuk memfilter konteks pohon.
void SetFlags(
DWORD dwFlags,
BOOL bRefresh = TRUE);
Parameter
dwFlags
[di] Bendera yang akan diatur.
bRefresh
[di] Boolean yang menentukan apakah CMFCShellTreeCtrl
harus segera di-refresh.
Keterangan
Meneruskan CMFCShellTreeCtrl
semua bendera yang diatur ke IShellFolder::EnumObjects. Untuk informasi selengkapnya tentang nilai bendera yang berbeda, lihat IShellFolder::EnumObjects.
CMFCShellTreeCtrl::SetRelatedList
Mengaitkan objek CMFCShellListCtrl dengan objek CMFCShellTreeCtrl.
void SetRelatedList(CMFCShellListCtrl* pShellList);
Parameter
pShellList
[di] Penunjuk ke CMFCShellListCtrl
objek.
Keterangan
Metode ini mengaitkan CMFCShellListCtrl
dengan CMFCShellTreeCtrl
. Objek ini dapat ditampilkan sebagai jendela seperti Explorer: jika pengguna memilih objek di CMFCShellTreeCtrl
, item terkait di CMFCShellListCtrl
akan diperbarui secara otomatis.
Gunakan metode CMFCShellTreeCtrl::GetRelatedList untuk mengambil yang CMFCShellListCtrl
terkait dengan CMFCShellTreeCtrl
.
Lihat juga
Bagan Hierarki
Kelas
Kelas CTreeCtrl
Kelas CMFCShellListCtrl