Metodo INameSpaceTreeControl::GetNextItem (shobjidl_core.h)

Articolo
03/05/2024

Recupera l'elemento successivo nell'albero in base al quale viene richiesto il metodo.

Sintassi

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

Parametri

[in, optional] psi

Tipo: IShellItem*

Elemento shell per il quale viene recuperato l'elemento successivo. Questo valore può essere NULL.

[in] nstcgi

Tipo: NSTCGNI

Tipo dell'elemento successivo. Questo valore può essere uno dei flag seguenti:

NSTCGNI_NEXT (0)

Elemento di pari livello successivo dell'elemento specificato.

NSTCGNI_NEXTVISIBLE (1)

Elemento visibile successivo nell'albero con qualsiasi relazione con l'elemento specificato. Ciò include un bambino (se c'è uno), il fratello successivo o anche uno dei fratelli del predecessore.

NSTCGNI_PREV (2)

Elemento di pari livello precedente dell'elemento specificato.

NSTCGNI_PREVVISIBLE (3)

Elemento visibile precedente che è un elemento di pari livello, un elemento discendente di pari livello o un elemento padre.

NSTCGNI_PARENT (4)

Elemento padre dell'elemento specificato.

NSTCGNI_CHILD (5)

Primo elemento figlio dell'elemento specificato.

NSTCGNI_FIRSTVISIBLE (6)

Primo elemento visibile assoluto nell'albero (non relativo all'elemento specificato).

NSTCGNI_LASTVISIBLE (7)

Ultimo elemento visibile assoluto nell'albero (non relativo all'elemento specificato).

[out] ppsiNext

Tipo: IShellItem**

Indirizzo di un puntatore a IShellItem che soddisfa i criteri per l'elemento successivo richiesto.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se non è presente alcun elemento successivo per il tipo selezionato, questa funzione restituisce E_FAIL con NULL per l'elemento restituito, ppsiNext.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite