CMFCShellTreeCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCShellTreeCtrl klasse breidt de CTreeCtrl-klassefunctionaliteit uit door een hiërarchie van Shell-items weer te geven.

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMFCShellTreeCtrl : public CTreeCtrl

Leden

Openbare methoden

Naam	Description
CMFCShellTreeCtrl::EnableShellContextMenu	Hiermee schakelt u het snelmenu in of uit.
CMFCShellTreeCtrl::GetFlags	Retourneert een combinatie van vlaggen die worden doorgegeven aan IShellFolder::EnumObjects.
CMFCShellTreeCtrl::GetItemPath	Hiermee wordt het pad naar een item opgehaald.
CMFCShellTreeCtrl::GetRelatedList	Hiermee wordt een aanwijzer geretourneerd naar het CMFCShellListCtrl-klasseobject dat samen met dit CMFCShellTreeCtrl object wordt gebruikt om een verkenner-achtig venster te maken.
CMFCShellTreeCtrl::OnChildNotify	Deze lidfunctie wordt aangeroepen door het bovenliggende venster van dit venster wanneer er een meldingsbericht wordt ontvangen dat van toepassing is op dit venster. (Overschrijft CWnd::OnChildNotify.)
CMFCShellTreeCtrl::OnGetItemIcon
CMFCShellTreeCtrl::OnGetItemText
CMFCShellTreeCtrl::Refresh	Hiermee wordt het huidige CMFCShellTreeCtrl object vernieuwd en opnieuw opgegeven.
CMFCShellTreeCtrl::SelectPath	Hiermee selecteert u het juiste structuurbeheeritem op basis van een opgegeven PIDL- of tekenreekspad.
CMFCShellTreeCtrl::SetFlags	Hiermee stelt u vlaggen in om de structuurcontext te filteren (vergelijkbaar met de vlaggen die worden gebruikt door IShellFolder::EnumObjects).
CMFCShellTreeCtrl::SetRelatedList	Hiermee stelt u een relatie in tussen het huidige CMFCShellTreeCtrl object en een CMFCShellListCtrl object.

Opmerkingen

Deze klasse breidt de CTreeCtrl klasse uit door uw programma in staat te stellen Windows Shell-items in de structuur op te nemen. Deze klasse kan worden gekoppeld aan een CMFCShellListCtrl object om een volledig Verkenner-venster te maken. Als u vervolgens een item in de structuur selecteert, wordt een lijst met Windows Shell-items in de bijbehorende lijst weergegeven.

Overnamehiërarchie

CObject

CCmdTarget-

CWnd

CTreeCtrl

CMFCShellTreeCtrl

Requirements

Header: afxshelltreeCtrl.h

Example

In het volgende voorbeeld ziet u hoe u een object van de CMFCShellTreeCtrl klasse maakt. Dit codefragment maakt deel uit van het Explorer-voorbeeld.

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

Hiermee schakelt u het snelmenu in.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
[in] Een Booleaanse waarde die aangeeft of het snelmenu moet worden ingeschakeld.

CMFCShellTreeCtrl::GetFlags

Retourneert de vlaggen die zijn ingesteld voor het CMFCShellTreeCtrl-klasseobject .

DWORD GetFlags() const;

Retourwaarde

Een DWORD-waarde die de combinatie van vlaggen aangeeft die momenteel zijn ingesteld.

Opmerkingen

De vlaggen die in de CMFCShellTreeCtrl vlag zijn ingesteld, worden verzonden naar de methode IShellFolder::EnumObjects wanneer het object wordt vernieuwd. U kunt de vlaggen wijzigen met de methode CMFCShellTreeCtrl::SetFlags .

CMFCShellTreeCtrl::GetItemPath

Hiermee haalt u het pad van een item in het CMFCShellTreeCtrl-klasseobject op.

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

Parameterwaarden

strPath
[uit] Een verwijzing naar een tekenreeksparameter. De methode schrijft het pad van het item naar deze parameter.

htreeItem
[in] Met de methode wordt het pad voor dit structuurbesturingselementitem opgehaald.

Retourwaarde

Niet-nul indien geslaagd; 0 anders.

Opmerkingen

Als deze methode mislukt, bevat strPath de lege tekenreeks.

Als u hTreeItem niet opgeeft, probeert deze methode de tekenreeks voor het geselecteerde item te verkrijgen. Als er geen item is geselecteerd en hTreeItem NULL is, mislukt deze methode.

CMFCShellTreeCtrl::GetRelatedList

Hiermee wordt een aanwijzer geretourneerd naar het CMFCShellListCtrl-klasseobject dat is gekoppeld aan dit CMFCShellTreeCtrl-object .

CMFCShellListCtrl* GetRelatedList() const;

Retourwaarde

Een aanwijzer naar het CMFCShellListCtrl object dat is gekoppeld aan dit structuurbesturingselementobject.

Opmerkingen

Door een CMFCShellListCtrl object samen met een CMFCShellTreeCtrl object te gebruiken, kunt u een Verkenner-achtig venster maken. Gebruik de methode CMFCShellTreeCtrl::SetRelatedList om de twee klassen te koppelen. Nadat deze zijn gekoppeld, wordt in het framework automatisch de CMFCShellListCtrl if-selectie in de CMFCShellTreeCtrl wijzigingen bijgewerkt.

CMFCShellTreeCtrl::OnChildNotify

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

Parameterwaarden

[in] Bericht
[in] wParam
[in] lParam
[in] pLResult

Retourwaarde

Opmerkingen

CMFCShellTreeCtrl::OnGetItemIcon

virtual int OnGetItemIcon(
    LPAFX_SHELLITEMINFO pItem,
    BOOL bSelected);

Parameterwaarden

[in] pItem
[in] bSelected

Retourwaarde

Opmerkingen

CMFCShellTreeCtrl::OnGetItemText

virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);

Parameterwaarden

[in] pItem

Retourwaarde

Opmerkingen

CMFCShellTreeCtrl::Refresh

Vernieuwt en herschildert de CMFCShellTreeCtrl.

void Refresh();

Opmerkingen

Roep deze methode aan om de hiërarchie te vernieuwen van de items die worden weergegeven in de CMFCShellTreeCtrl.

CMFCShellTreeCtrl::SelectPath

Selecteert een item in de CMFCShellTreeCtrl-klasse op basis van het opgegeven pad.

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

Parameterwaarden

lpszPath
[in] Een tekenreeks die het pad van een item aangeeft.

lpidl
[in] Een PIDL waarmee het item wordt opgegeven

Retourwaarde

S_OK indien geslaagd; E_FAIL anders.

CMFCShellTreeCtrl::SetFlags

Hiermee stelt u vlaggen in om de structuurcontext te filteren.

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

Parameterwaarden

dwFlags
[in] De vlaggen die moeten worden ingesteld.

bRefresh
[in] Een Booleaanse waarde die aangeeft of de CMFCShellTreeCtrl waarde onmiddellijk moet worden vernieuwd.

Opmerkingen

Hiermee CMFCShellTreeCtrl worden alle ingestelde vlaggen doorgegeven aan IShellFolder::EnumObjects. Zie IShellFolder::EnumObjects voor meer informatie over de waarden van verschillende vlaggen.

CMFCShellTreeCtrl::SetRelatedList

Hiermee koppelt u een CMFCShellListCtrl-object aan een CMFCShellTreeCtrl-object .

void SetRelatedList(CMFCShellListCtrl* pShellList);

Parameterwaarden

pShellList
[in] Een aanwijzer naar een CMFCShellListCtrl object.

Opmerkingen

Deze methode koppelt een CMFCShellListCtrl aan een CMFCShellTreeCtrl. Deze objecten kunnen worden weergegeven als een Verkenner-achtig venster: als de gebruiker een object selecteert in de CMFCShellTreeCtrl, worden de bijbehorende items in het CMFCShellListCtrl venster automatisch bijgewerkt.

Gebruik de methode CMFCShellTreeCtrl::GetRelatedList om de CMFCShellListCtrl gekoppelde items op CMFCShellTreeCtrlte halen.

Zie ook

Hiërarchiegrafiek
Klassen
CTreeCtrl-klasse
CMFCShellListCtrl-klasse