Método IExplorerBrowser::FillFromObject (shobjidl_core.h)

  • Artículo

Crea una carpeta de resultados y la rellena con elementos.

Sintaxis

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

Parámetros

[in] punk

Tipo: IUnknown*

Puntero de interfaz en el objeto de origen que rellenará IResultsFolder. Puede ser un IDataObject o cualquier objeto que se pueda usar con INamespaceWalk.

[in] dwFlags

Tipo: EXPLORER_BROWSER_FILL_FLAGS

Uno de los valores de EXPLORER_BROWSER_FILL_FLAGS .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El objeto pasado a través del puntero de interfaz punk rellena IResultsFolder.

El parámetro dwFlags puede ser cualquiera de los EXPLORER_BROWSER_FILL_FLAGS o cualquiera de las marcas definidas en el parámetro wFlags de BrowseObject, excepto las marcas que indican la navegación.

El parámetro punk puede ser cualquier objeto que pueda consumir INamespaceWalk . Si se llama con EBF_SELECTFROMDATAOBJECT, punk debe ser un IDataObject y el espacio de nombres se recorrerá en el nivel primario del objeto de datos, incluidos todos los elementos del mismo nivel, pero seleccionar solo los contenidos en el objeto de datos. Esta marca se usa normalmente cuando FOLDERSETTINGS tiene habilitado FWF_CHECKSELECT , lo que permite la selección de comprobación de un conjunto de elementos que se han compilado en el objeto de datos.

Nota Si un puntero a una lista de identificadores de elemento (PIDL) del objeto de datos está completo, la carpeta primaria no se puede recorrer correctamente, ya que los elementos de carpeta de escritorio se agregarían a la lista.
 
Se puede llamar a este método más de una vez, con cada llamada sucesiva agregando elementos adicionales a la vista. Se puede llamar a IExplorerBrowser::RemoveAll para borrar el contenido de la carpeta de resultados. Se debe llamar a esta función con EBF_NODROPTARGET para evitar que los usuarios arrastren nuevos elementos a la vista, a menos que se desee. También se recomienda establecer EBO_NAVIGATEONCE para que el explorador permanezca en ResultsFolder, lo que impide que el usuario vaya a una carpeta que se pueda representar en el objeto de datos.

Para manipular los elementos de la carpeta de resultados directamente, llame a IExplorerBrowser::GetCurrentView para obtener la vista de ExplorerBrowser y, a continuación, pida a la vista la carpeta de resultados mediante GetFolder. El uso de la carpeta de resultados obtenidos permite la manipulación de los datos de la carpeta con más flexibilidad que con los métodos que proporciona IExplorerBrowser .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)

Consulte también

FOLDERFLAGS

IExplorerBrowser