CMFCShellTreeCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCShellTreeCtrl osztály kibővíti a CTreeCtrl osztály funkcióit a Shell-elemek hierarchiájának megjelenítésével.

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CMFCShellTreeCtrl : public CTreeCtrl

Tagok

Nyilvános metódusok

Név	Description
CMFCShellTreeCtrl::EnableShellContextMenu	Engedélyezi vagy letiltja a helyi menüt.
CMFCShellTreeCtrl::GetFlags	Az IShellFolder::EnumObjects parancsnak átadott jelzők kombinációját adja vissza.
CMFCShellTreeCtrl::GetItemPath	Lekéri egy elem elérési útját.
CMFCShellTreeCtrl::GetRelatedList	Egy mutatót ad vissza a CMFCShellListCtrl osztályobjektumra , amelyet ezzel CMFCShellTreeCtrl az objektummal együtt használnak explorer-szerű ablak létrehozásához.
CMFCShellTreeCtrl::OnChildNotify	Ezt a tagfüggvényt az ablak szülőablaka hívja meg, amikor egy erre az ablakra vonatkozó értesítési üzenetet kap. (Felülbírálja a CWnd::OnChildNotify.)
CMFCShellTreeCtrl::OnGetItemIcon
CMFCShellTreeCtrl::OnGetItemText
CMFCShellTreeCtrl::Frissítés	Frissíti és újrafesti az aktuális CMFCShellTreeCtrl objektumot.
CMFCShellTreeCtrl::SelectPath	A megadott PIDL vagy sztring elérési útja alapján kiválasztja a megfelelő favezérlő elemet.
CMFCShellTreeCtrl::SetFlags	Beállítja a jelölőket a fakörnyezet szűréséhez (hasonlóan a használt jelzőkhöz IShellFolder::EnumObjects).
CMFCShellTreeCtrl::SetRelatedList	Az aktuális CMFCShellTreeCtrl objektum és egy CMFCShellListCtrl objektum közötti kapcsolatot állítja be.

Megjegyzések

Ez az osztály kibővíti az CTreeCtrl osztályt azáltal, hogy lehetővé teszi a program számára, hogy a Windows Shell-elemeket is belefoglalja a fára. Ez az osztály társítható egy CMFCShellListCtrl objektummal egy teljes Explorer-ablak létrehozásához. Ezután a fa egyik elemének kiválasztásával megjelenik a Windows Shell-elemek listája a társított listában.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CTreeCtrl

CMFCShellTreeCtrl

Requirements

Fejléc: afxshelltreeCtrl.h

Example

Az alábbi példa bemutatja, hogyan hozható létre az CMFCShellTreeCtrl osztály egy objektuma. Ez a kódrészlet az Explorer-minta része.

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

Engedélyezi a helyi menüt.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Logikai érték, amely meghatározza, hogy engedélyezni szeretné-e a helyi menüt.

CMFCShellTreeCtrl::GetFlags

A CMFCShellTreeCtrl osztályobjektumhoz beállított jelzőket adja vissza.

DWORD GetFlags() const;

Visszaadott érték

Egy DWORD érték, amely az aktuálisan beállított jelzők kombinációját határozza meg.

Megjegyzések

A megadott CMFCShellTreeCtrl jelzők az IShellFolder::EnumObjects metódusba kerülnek, amikor az objektum frissül. A jelölőket a CMFCShellTreeCtrl::SetFlags metódussal módosíthatja .

CMFCShellTreeCtrl::GetItemPath

Lekéri egy elem elérési útját a CMFCShellTreeCtrl osztályobjektumban .

BOOL GetItemPath(
    CString& strPath,
    HTREEITEM htreeItem = NULL) const;

Paraméterek

strPath
[kifelé] Hivatkozás egy sztringparaméterre. A metódus az elem elérési útját írja ehhez a paraméterhez.

htreeItem
[in] A metódus lekéri ennek a favezérlőelemnek az elérési útját.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

Megjegyzések

Ha ez a módszer nem sikerül, az strPath az üres sztringet tartalmazza.

Ha nem adja meg a hTreeItem értéket, ez a metódus megpróbálja beolvasni az aktuálisan kijelölt elem sztringét. Ha nincs kijelölve elem, és a hTreeItem értéke NULL, ez a metódus sikertelen lesz.

CMFCShellTreeCtrl::GetRelatedList

Az ehhez a CMFCShellTreeCtrl objektumhoz társított CMFCShellListCtrl osztályobjektumra mutató mutatót ad vissza.

CMFCShellListCtrl* GetRelatedList() const;

Visszaadott érték

A favezérlő objektumhoz társított objektumra mutató mutató CMFCShellListCtrl .

Megjegyzések

Ha objektumot CMFCShellListCtrl használ egy CMFCShellTreeCtrl objektummal együtt, létrehozhat egy Explorer-szerű ablakot. Használja a CMFCShellTreeCtrl::SetRelatedList metódust a két osztály társításához. A társítás után a keretrendszer automatikusan frissíti a CMFCShellListCtrl módosításokat CMFCShellTreeCtrl .

CMFCShellTreeCtrl::OnChildNotify

virtual BOOL OnChildNotify(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pLResult);

Paraméterek

[in] Üzenetet
[in] wParam
[in] lParam
[in] pLResult

Visszaadott érték

Megjegyzések

CMFCShellTreeCtrl::OnGetItemIcon

virtual int OnGetItemIcon(
    LPAFX_SHELLITEMINFO pItem,
    BOOL bSelected);

Paraméterek

[in] pItem
[in] b Kijelölve

Visszaadott érték

Megjegyzések

CMFCShellTreeCtrl::OnGetItemText

virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);

Paraméterek

[in] pItem

Visszaadott érték

Megjegyzések

CMFCShellTreeCtrl::Frissítés

Frissíti és újrafesti a CMFCShellTreeCtrl elemet.

void Refresh();

Megjegyzések

Hívja meg ezt a metódust, hogy frissítse a hierarchiát a nézetben megjelenő elemek között CMFCShellTreeCtrl.

CMFCShellTreeCtrl::SelectPath

Kiválaszt egy elemet a CMFCShellTreeCtrl osztályban a megadott elérési út alapján.

BOOL SelectPath(LPCTSTR lpszPath);
BOOL SelectPath(LPCITEMIDLIST lpidl);

Paraméterek

lpszPath
[in] Egy elem elérési útját meghatározó sztring.

lpidl
[in] Az elemet meghatározó PIDL

Visszaadott érték

sikeres S_OK; E_FAIL ellenkező esetben.

CMFCShellTreeCtrl::SetFlags

Jelölőket állít be a fakörnyezet szűréséhez.

void SetFlags(
    DWORD dwFlags,
    BOOL bRefresh = TRUE);

Paraméterek

dwFlags
[in] A beállítani kívánt jelzők.

bRefresh
[in] Logikai érték, amely meghatározza, hogy a CMFCShellTreeCtrl frissítést azonnal meg kell-e adni.

Megjegyzések

Az CMFCShellTreeCtrl összes jelölőt átadja az IShellFoldernek::EnumObjects. A különböző jelzők értékeivel kapcsolatos további információkért lásd: IShellFolder::EnumObjects.

CMFCShellTreeCtrl::SetRelatedList

CMFCShellListCtrl objektumot társít egy CMFCShellTreeCtrl objektumhoz.

void SetRelatedList(CMFCShellListCtrl* pShellList);

Paraméterek

pShellList
[in] Egy objektumra mutató CMFCShellListCtrl mutató.

Megjegyzések

Ez a metódus társít egy CMFCShellListCtrlCMFCShellTreeCtrl. Előfordulhat, hogy ezek az objektumok Explorer-szerű ablakként jelennek meg: ha a felhasználó kiválaszt egy objektumot a CMFCShellTreeCtrlfájlban, a program automatikusan frissíti a CMFCShellListCtrl hozzájuk tartozó elemeket.

Használja a CMFCShellTreeCtrl::GetRelatedList metódust egy CMFCShellListCtrl .CMFCShellTreeCtrl

Lásd még

hierarchiadiagram
osztályok
CTreeCtrl osztály
CMFCShellListCtrl osztály