INameSpaceTreeControl ::InsertRoot, méthode (shobjidl_core.h)

  • Article

Insère un élément Shell sur un élément racine dans une arborescence.

Syntaxe

HRESULT InsertRoot(
  [in]           int              iIndex,
  [in]           IShellItem       *psiRoot,
  [in]           SHCONTF          grfEnumFlags,
  [in]           NSTCROOTSTYLE    grfRootStyle,
  [in, optional] IShellItemFilter *pif
);

Paramètres

[in] iIndex

Type : int

Index au niveau duquel insérer la racine.

[in] psiRoot

Type : IShellItem*

Pointeur vers l’élément Shell en cours d’insertion.

[in] grfEnumFlags

Type : SHCONTF

Énumère les qualités de la racine et de tous ses enfants. Une des valeurs de type SHCONTF.

[in] grfRootStyle

Type : NSTCROOTSTYLE

Style de la racine en cours d’insertion. Une ou plusieurs des valeurs suivantes (les indicateurs peuvent être combinés à l’aide d’un or au niveau du bit).

NSTCRS_VISIBLE (0x0000)

La racine est visible, ainsi que les éléments. Mutuellement exclusif avec NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

La racine est masquée afin que seuls les enfants soient visibles. Mutuellement exclusif avec NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

La racine est développée lors de l’initialisation.

[in, optional] pif

Type : IShellItemFilter*

Pointeur vers IShellItemFilter qui vous permet de filtrer les éléments de l’arborescence qui s’affichent. S’il est fourni, chaque élément est personnalisable avec un indicateur SHCONTF . Cette valeur peut être NULL si aucun filtre n’est requis.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)