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

要求されたメソッドに従って、ツリー内の次の項目を取得します。

構文

HRESULT GetNextItem(
  [in, optional] IShellItem *psi,
  [in]           NSTCGNI    nstcgi,
  [out]          IShellItem **ppsiNext
);

パラメーター

[in, optional] psi

種類: IShellItem*

次の項目が取得されるシェル項目。 この値は NULL にすることができます。

[in] nstcgi

種類: NSTCGNI

次の項目の型。 この値には、次のいずれかのフラグを指定できます。

NSTCGNI_NEXT (0)

指定された項目の次の兄弟。

NSTCGNI_NEXTVISIBLE (1)

ツリー内の、指定された項目とのリレーションシップを持つ次に表示される項目。 これには、子 (存在する場合)、次の兄弟、または先祖の兄弟のいずれかが含まれます。

NSTCGNI_PREV (2)

指定された項目の前の兄弟項目。

NSTCGNI_PREVVISIBLE (3)

兄弟アイテム、兄弟の子孫アイテム、または親アイテムである、前に表示される項目。

NSTCGNI_PARENT (4)

指定されたアイテムの親アイテム。

NSTCGNI_CHILD (5)

指定した項目の最初の子項目。

NSTCGNI_FIRSTVISIBLE (6)

ツリー内の最初に表示される絶対項目 (指定された項目に対する相対項目ではありません)。

NSTCGNI_LASTVISIBLE (7)

ツリー内の最後に表示される絶対項目 (指定された項目に対する相対的な項目ではありません)。

[out] ppsiNext

種類: IShellItem**

要求された次の項目の条件に適合する IShellItem へのポインターのアドレス。

戻り値

種類: HRESULT

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

注釈

選択した型に次の項目がない場合、この関数は、返されるアイテム ppsiNext に対して NULL を指定してE_FAILを返します。

要件