IExplorerBrowser::FillFromObject 方法 (shobjidl_core.h)

创建一个结果文件夹,并用项目填充该文件夹。

语法

HRESULT FillFromObject(
  [in] IUnknown                    *punk,
  [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags
);

参数

[in] punk

类型: IUnknown*

将填充 IResultsFolder 的源对象上的接口指针。 这可以是 IDataObject ,也可以是可与 INamespaceWalk 一起使用的任何对象。

[in] dwFlags

类型: EXPLORER_BROWSER_FILL_FLAGS

EXPLORER_BROWSER_FILL_FLAGS值之

返回值

类型: HRESULT

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

注解

通过接口指针 朋克 传递的对象填充 IResultsFolder

参数 dwFlags 可以是任何 EXPLORER_BROWSER_FILL_FLAGSBrowseObjectwFlags 参数中定义的任何标志,但指示导航的标志除外。

参数 punk 可以是 INamespaceWalk 可以使用的任何对象。 如果使用 EBF_SELECTFROMDATAOBJECT 调用 ,punk 必须是 IDataObject ,命名空间将在数据对象的父级别(包括所有对等项)进行访问,但仅选择数据对象中包含的项。 当 FOLDERSETTINGS 已启用FWF_CHECKSELECT时,最常使用此标志,从而允许检查选择已在数据对象中编译的一组项。

注意 如果指向数据对象中 PIDL) 的项目标识符列表 (指针完全限定,则无法成功遍历父文件夹,因为桌面文件夹项目将添加到列表中。
 
此方法可以多次调用,每次连续调用都会向视图添加其他项。 可以调用 IExplorerBrowser::RemoveAll 来清除结果文件夹的内容。 应使用 EBF_NODROPTARGET 调用此函数,以防止用户将新项目拖放到视图中,除非需要。 还建议设置 EBO_NAVIGATEONCE ,以便浏览器将停留在 ResultsFolder 中,从而阻止用户导航到数据对象中可能表示的文件夹。

若要直接操作结果文件夹中的项目,请调用 IExplorerBrowser::GetCurrentView 从 ExplorerBrowser 获取视图,然后使用 GetFolder 请求视图查找结果文件夹。 与 使用 IExplorerBrowser 提供的方法相比,使用获取的结果文件夹可以更灵活地操作文件夹中的数据。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

FOLDERFLAGS

IExplorerBrowser