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 錯誤碼。

備註

透過介面指標 punk 傳遞的物件會填滿 IResultsFolder

參數 dwFlags 可以是任何 EXPLORER_BROWSER_FILL_FLAGS 或任何 BrowseObjectwFlags 參數中定義的旗標,但指出導覽的旗標除外。

參數 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