Метод INameSpaceTreeControl::InsertRoot (shobjidl_core.h)

Статья
03/05/2024

Вставляет элемент оболочки в корневой элемент дерева.

Синтаксис

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.

[in] grfRootStyle

Тип: NSTCROOTSTYLE

Стиль вставляемого корня. Одно или несколько из следующих значений (флаги можно объединить с помощью побитового ИЛИ).

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
Header	shobjidl_core.h (включая Shobjidl.h)

Поделиться через