Método INameSpaceTreeControl::GetNextItem (shobjidl_core.h)

Recupera o próximo item na árvore de acordo com qual método é solicitado.

Sintaxe

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

Parâmetros

[in, optional] psi

Tipo: IShellItem*

O item shell para o qual o próximo item está sendo recuperado. Esse valor pode ser NULL.

[in] nstcgi

Tipo: NSTCGNI

O tipo do próximo item. Esse valor pode ser um dos seguintes sinalizadores:

NSTCGNI_NEXT (0)

O próximo irmão do item especificado.

NSTCGNI_NEXTVISIBLE (1)

O próximo item visível na árvore que tem qualquer relação com o item especificado. Isso inclui um filho (se houver um), o próximo irmão ou até mesmo um dos irmãos do ancestral.

NSTCGNI_PREV (2)

O item irmão anterior do item especificado.

NSTCGNI_PREVVISIBLE (3)

O item visível anterior que é um item irmão, item descendente irmão ou um item pai.

NSTCGNI_PARENT (4)

O item pai do item especificado.

NSTCGNI_CHILD (5)

O primeiro item filho do item especificado.

NSTCGNI_FIRSTVISIBLE (6)

O primeiro item visível absoluto na árvore (não em relação ao item especificado).

NSTCGNI_LASTVISIBLE (7)

O último item visível absoluto na árvore (não em relação ao item especificado).

[out] ppsiNext

Tipo: IShellItem**

O endereço de um ponteiro para o IShellItem que se ajusta aos critérios para o próximo item que foi solicitado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se não houver nenhum próximo item para o tipo selecionado, essa função retornará E_FAIL com NULL para o item retornado, ppsiNext.

Requisitos