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値の 1 つ。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

インターフェイス ポインター のパンク を介して渡されたオブジェクトは 、IResultsFolder を塗りつぶします。

パラメーター dwFlags には、ナビゲーションを示すフラグを除き、 EXPLORER_BROWSER_FILL_FLAGS または BrowseObject の wFlags パラメーターで定義されているフラグのいずれかを指定できます。

パラメーター パンク には、 INamespaceWalk で使用できる任意のオブジェクトを指定できます。 EBF_SELECTFROMDATAOBJECTで呼び出された場合、punk は IDataObject である必要があります。名前空間は、すべてのピア項目を含むデータ オブジェクトの親レベルでウォークされますが、データ オブジェクトに含まれるもののみを選択します。 このフラグは、FOLDERSETTINGS が有効FWF_CHECKSELECT場合に最も一般的に使用され、データ オブジェクトでコンパイルされた一連の項目をチェック選択できます。

メモ データ オブジェクト内の項目識別子リスト (PIDL) へのポインターが完全修飾されている場合、デスクトップ フォルダー項目がリストに追加されるため、親フォルダーを正常にウォークできません。
 
このメソッドは複数回呼び出され、連続する呼び出しごとにビューに項目が追加されます。 IExplorerBrowser::RemoveAll を呼び出して、結果フォルダーの内容をクリアできます。 必要な場合を除き、ユーザーが新しい項目をビューにドラッグ ドロップできないようにするには、この関数を EBF_NODROPTARGET で呼び出す必要があります。 また、ブラウザーが ResultsFolder に留まり、ユーザーがデータ オブジェクトで表されるフォルダーに移動できないようにするには、EBO_NAVIGATEONCEを設定することもお勧めします。

結果フォルダー内のアイテムを直接操作するには、 IExplorerBrowser::GetCurrentView を呼び出して ExplorerBrowser からビューを取得し、 GetFolder を使用して結果フォルダーのビューを確認します。 取得した結果フォルダーを使用すると、 IExplorerBrowser が提供するメソッドよりも柔軟性の高いフォルダー内のデータを操作できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)

こちらもご覧ください

FOLDERFLAGS

IExplorerBrowser