INameSpaceTreeControl::InsertRoot-Methode (shobjidl_core.h)

Artikel
03/02/2024

Fügt ein Shellelement in ein Stammelement in einer Struktur ein.

Syntax

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

Parameter

[in] iIndex

Typ: int

Der Index, an dem der Stamm eingefügt werden soll.

[in] psiRoot

Typ: IShellItem*

Ein Zeiger auf das Shellelement, das eingefügt wird.

[in] grfEnumFlags

Typ: SHCONTF

Listet die Eigenschaften der Wurzel und all ihrer Kinder auf. Einer der Werte vom Typ SHCONTF.

[in] grfRootStyle

Typ: NSTCROOTSTYLE

Der Stil des Stamms, der eingefügt wird. Mindestens einer der folgenden Werte (Flags können mit einem bitweisen OR kombiniert werden).

NSTCRS_VISIBLE (0x0000)

Sowohl der Stamm als auch die Elemente sind sichtbar. Schließen Sie sich mit NSTCRS_HIDDEN gegenseitig aus.

NSTCRS_HIDDEN (0x0001)

Der Stamm ist ausgeblendet, sodass nur die untergeordneten Elemente sichtbar sind. Schließen Sie sich mit NSTCRS_VISIBLE gegenseitig aus.

NSTCRS_EXPANDED (0x0002)

Der Stamm wird bei der Initialisierung erweitert.

[in, optional] pif

Typ: IShellItemFilter*

Ein Zeiger auf den IShellItemFilter , mit dem Sie filtern können, welche Elemente in der Struktur angezeigt werden. Wenn angegeben, kann jedes Element mit einem SHCONTF-Flag angepasst werden. Dieser Wert kann NULL sein, wenn kein Filter erforderlich ist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über