CMFCShellTreeCtrl, classe

La CMFCShellTreeCtrl classe étend la fonctionnalité de classe CTreeCtrl en affichant une hiérarchie d’éléments Shell.

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCShellTreeCtrl : public CTreeCtrl

Membres

Méthodes publiques

Nom	Description
CMFCShellTreeCtrl ::EnableShellContextMenu	Active ou désactive le menu contextuel.
CMFCShellTreeCtrl ::GetFlags	Retourne une combinaison d’indicateurs passés à IShellFolder ::EnumObjects.
CMFCShellTreeCtrl ::GetItemPath	Récupère le chemin d’accès à un élément.
CMFCShellTreeCtrl ::GetRelatedList	Retourne un pointeur vers l’objet CMFCShellListCtrl Class qui est utilisé avec cet CMFCShellTreeCtrl objet pour créer une fenêtre de type Explorateur.
CMFCShellTreeCtrl ::OnChildNotify	Cette fonction membre est appelée par la fenêtre parente de cette fenêtre lorsqu’elle reçoit un message de notification qui s’applique à cette fenêtre. (Remplacements CWnd ::OnChildNotify.)
CMFCShellTreeCtrl ::OnGetItemIcon
CMFCShellTreeCtrl ::OnGetItemText
CMFCShellTreeCtrl ::Refresh	Actualise et repeint l’objet actuel CMFCShellTreeCtrl .
CMFCShellTreeCtrl ::SelectPath	Sélectionne l’élément de contrôle d’arborescence approprié en fonction d’un chemin d’accès piDL ou chaîne fourni.
CMFCShellTreeCtrl ::SetFlags	Définit des indicateurs pour filtrer le contexte d’arborescence (comme les indicateurs utilisés par IShellFolder::EnumObjects).
CMFCShellTreeCtrl ::SetRelatedList	Définit une relation entre l’objet actuel CMFCShellTreeCtrl et un CMFCShellListCtrl objet.

Notes

Cette classe étend la CTreeCtrl classe en permettant à votre programme d’inclure des éléments Windows Shell dans l’arborescence. Cette classe peut être associée à un CMFCShellListCtrl objet pour créer une fenêtre d’Explorateur complète. Ensuite, la sélection d’un élément dans l’arborescence affiche une liste d’éléments Windows Shell dans la liste associée.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CTreeCtrl

CMFCShellTreeCtrl

Spécifications

En-tête : afxshelltreeCtrl.h

Exemple

L'exemple suivant montre comment créer un objet de la classe CMFCShellTreeCtrl. Cet extrait de code fait partie de l’exemple d’Explorateur.

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

Active le menu contextuel.

void EnableShellContextMenu(BOOL bEnable = TRUE);

Paramètres

bEnable
[in] Boolean qui spécifie s’il faut activer le menu contextuel.

CMFCShellTreeCtrl ::GetFlags

Retourne les indicateurs définis pour l’objet CMFCShellTreeCtrl, classe .

DWORD GetFlags() const;

Valeur de retour

Valeur DWORD qui spécifie la combinaison d’indicateurs actuellement défini.

Notes

Les indicateurs définis dans le fichier CMFCShellTreeCtrl sont envoyés à la méthode IShellFolder ::EnumObjects chaque fois que l’objet est actualisé. Vous pouvez modifier les indicateurs avec la méthode CMFCShellTreeCtrl ::SetFlags .

CMFCShellTreeCtrl ::GetItemPath

Récupère le chemin d’accès d’un élément dans l’objet CMFCShellTreeCtrl, classe .

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

Paramètres

strPath
[out] Référence à un paramètre de chaîne. La méthode écrit le chemin d’accès de l’élément dans ce paramètre.

htreeItem
[in] La méthode récupère le chemin d’accès de cet élément de contrôle d’arborescence.

Valeur de retour

Différent de zéro s’il réussit ; Sinon, 0.

Notes

Si cette méthode échoue, strPath contient la chaîne vide.

Si vous ne spécifiez pas hTreeItem, cette méthode tente d’obtenir la chaîne de l’élément actuellement sélectionné. Si aucun élément n’est sélectionné et que hTreeItem a la valeur NULL, cette méthode échoue.

CMFCShellTreeCtrl ::GetRelatedList

Renvoie un pointeur vers l’objet CMFCShellListCtrl Class associé à cet objet CMFCShellTreeCtrl .

CMFCShellListCtrl* GetRelatedList() const;

Valeur de retour

Pointeur vers l’objet CMFCShellListCtrl associé à cet objet de contrôle d’arborescence.

Notes

En utilisant un CMFCShellListCtrl objet avec un CMFCShellTreeCtrl objet, vous pouvez créer une fenêtre de type Explorateur. Utilisez la méthode CMFCShellTreeCtrl ::SetRelatedList pour associer les deux classes. Une fois qu’ils sont associés, l’infrastructure met automatiquement à jour la CMFCShellListCtrl sélection dans les CMFCShellTreeCtrl modifications.

CMFCShellTreeCtrl ::OnChildNotify

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

Paramètres

[in] Message
[in] Wparam
[in] Lparam
[in] pLResult

Valeur de retour

Notes

CMFCShellTreeCtrl ::OnGetItemIcon

virtual int OnGetItemIcon(
    LPAFX_SHELLITEMINFO pItem,
    BOOL bSelected);

Paramètres

[in] pItem
[in] bSelected

Valeur de retour

Notes

CMFCShellTreeCtrl ::OnGetItemText

virtual CString OnGetItemText(LPAFX_SHELLITEMINFO pItem);

Paramètres

[in] pItem

Valeur de retour

Notes

CMFCShellTreeCtrl ::Refresh

Actualise et repeint le CMFCShellTreeCtrl.

void Refresh();

Notes

Appelez cette méthode pour actualiser la hiérarchie des éléments affichés dans le CMFCShellTreeCtrl.

CMFCShellTreeCtrl ::SelectPath

Sélectionne un élément dans la classe CMFCShellTreeCtrl en fonction du chemin d’accès fourni.

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

Paramètres

lpszPath
[in] Chaîne qui spécifie le chemin d’accès d’un élément.

lpidl
[in] PIDL qui spécifie l’élément

Valeur de retour

S_OK en cas de réussite ; E_FAIL sinon.

CMFCShellTreeCtrl ::SetFlags

Définit des indicateurs pour filtrer le contexte de l’arborescence.

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

Paramètres

dwFlags
[in] Indicateurs à définir.

bRefresh
[in] Valeur booléenne qui spécifie si la CMFCShellTreeCtrl valeur doit être actualisée immédiatement.

Notes

Passe CMFCShellTreeCtrl tous les indicateurs définis à IShellFolder ::EnumObjects. Pour plus d’informations sur les valeurs des différents indicateurs, consultez IShellFolder ::EnumObjects.

CMFCShellTreeCtrl ::SetRelatedList

Associe un objet CMFCShellListCtrl à un objet CMFCShellTreeCtrl .

void SetRelatedList(CMFCShellListCtrl* pShellList);

Paramètres

pShellList
[in] Pointeur vers un CMFCShellListCtrl objet.

Notes

Cette méthode associe un CMFCShellListCtrlCMFCShellTreeCtrl. Ces objets peuvent être affichés sous la forme d’une fenêtre de type Explorateur : si l’utilisateur sélectionne un objet dans le CMFCShellTreeCtrl, les éléments associés dans le CMFCShellListCtrl fichier seront automatiquement mis à jour.

Utilisez la méthode CMFCShellTreeCtrl ::GetRelatedList pour récupérer l’élément CMFCShellListCtrl associé à un CMFCShellTreeCtrl.

Voir aussi

Graphique hiérarchique
Classes
CTreeCtrl, classe
CMFCShellListCtrl, classe