INameSpaceTreeControl::InsertRoot メソッド (shobjidl_core.h)

ツリー内のルート項目にシェル項目を挿入します。

構文

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

パラメーター

[in] iIndex

型: int

ルートを挿入する位置のインデックス。

[in] psiRoot

種類: IShellItem*

挿入されるシェル項目へのポインター。

[in] grfEnumFlags

種類: SHCONTF

ルートとそのすべての子の品質を列挙します。 SHCONTF 型の値の 1 つ。

[in] grfRootStyle

型: NSTCROOTSTYLE

挿入されるルートのスタイル。 次の 1 つ以上の値 (フラグはビットごとの OR を使用して組み合わせることができます)。

NSTCRS_VISIBLE (0x0000)

ルートは、項目と同様に表示されます。 NSTCRS_HIDDENと相互に排他的です。

NSTCRS_HIDDEN (0x0001)

ルートは非表示になっているため、子のみが表示されます。 NSTCRS_VISIBLEと相互に排他的です。

NSTCRS_EXPANDED (0x0002)

初期化時にルートが展開されます。

[in, optional] pif

種類: IShellItemFilter*

ツリー内のどの項目が表示されているかをフィルター処理できる IShellItemFilter へのポインター。 指定した場合、すべての項目は SHCONTF フラグを使用してカスタマイズできます。 フィルターが必要ない場合、この値は NULL にすることができます 。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)