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

CObject

CCmdTarget

CWnd

CTreeCtrl

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.

Baca juga

Bagan Hierarki
Kelas
Kelas CTreeCtrl
Kelas CMFCShellListCtrl