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


Метод IFileDialog2::SetNavigationRoot (shobjidl.h)

Указывает расположение верхнего уровня, с которого начинается просмотр пространства имен, например в параметре "Обзор папки" диалогового окна "Сохранить". Пользователи не могут перемещаться над этим расположением.

Синтаксис

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

Параметры

[in] psi

Тип: IShellItem

Указатель на объект IShellItem , представляющий корневой каталог навигации.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

SetNavigationRoot может использоваться приложениями, которые хотят ограничить навигацию определенной областью пространства имен оболочки. Элементы в области навигации заменяются предоставленным элементом, чтобы пользователь не переходил за пределы этой части пространства имен.

Этот метод не может вызываться при отображении диалогового окна.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl.h
Библиотека Comdlg32.lib
DLL Comdlg32.dll (версия 6.1 или более поздняя)

См. также раздел

IFileDialog2