Метод 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 .

Комментарии

Если для выбранного типа нет следующего элемента, эта функция возвращает E_FAIL со значением NULL для возвращаемого элемента ppsiNext.

Требования