IFileDialog2::SetNavigationRoot 方法 (shobjidl.h)

指定从中开始浏览命名空间的顶级位置,例如在 “保存 ”对话框的“ 浏览文件夹 ”选项中。 用户无法在此位置上方导航。

语法

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

参数

[in] psi

类型: IShellItem

指向表示导航根的 IShellItem 对象的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

SetNavigationRoot 可由想要将导航限制为 Shell 命名空间的特定区域的应用程序使用。 导航窗格中的项将替换为提供的项,以指导用户在命名空间的这一部分之外导航。

在显示对话框时,无法调用此方法。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 shobjidl.h
Library Comdlg32.lib
DLL Comdlg32.dll (版本 6.1 或更高版本)

另请参阅

IFileDialog2