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

  • Artigo

Cria uma pasta de resultados e a preenche com itens.

Sintaxe

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

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro de interface no objeto de origem que preencherá o IResultsFolder. Isso pode ser um IDataObject ou qualquer objeto que possa ser usado com INamespaceWalk.

[in] dwFlags

Tipo: EXPLORER_BROWSER_FILL_FLAGS

Um dos valores EXPLORER_BROWSER_FILL_FLAGS .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O objeto passado por meio do ponteiro de interface punk preenche IResultsFolder.

O parâmetro dwFlags pode ser qualquer um dos EXPLORER_BROWSER_FILL_FLAGS ou qualquer um dos sinalizadores definidos no parâmetro wFlags do BrowseObject, exceto para sinalizadores que indicam navegação.

O parâmetro punk pode ser qualquer objeto que INamespaceWalk possa consumir. Se chamado com EBF_SELECTFROMDATAOBJECT, punk deve ser um IDataObject e o namespace será andado no nível pai do objeto de dados, incluindo todos os itens pares, mas selecionando apenas aqueles contidos no objeto de dados. Esse sinalizador é mais comumente usado quando FOLDERSETTINGSFWF_CHECKSELECT habilitado, permitindo marcar seleção de um conjunto de itens que foram compilados no objeto de dados.

Nota Se um ponteiro para uma lista de identificadores de item (PIDL) no objeto de dados for totalmente qualificado, a pasta pai não poderá ser andada com êxito, pois os itens da pasta da área de trabalho seriam adicionados à lista.
 
Esse método pode ser chamado mais de uma vez, com cada chamada sucessiva adicionando itens adicionais à exibição. IExplorerBrowser::RemoveAll pode ser chamado para limpar o conteúdo da pasta de resultados. Essa função deve ser chamada com EBF_NODROPTARGET para impedir que os usuários arrastem a remoção de novos itens para a exibição, a menos que isso seja desejado. A configuração EBO_NAVIGATEONCE também é recomendada para que o navegador permaneça no ResultsFolder, impedindo que o usuário navegue até uma pasta que possa ser representada no objeto de dados.

Para manipular itens na pasta de resultados diretamente, chame IExplorerBrowser::GetCurrentView para obter a exibição do ExplorerBrowser e, em seguida, solicite a pasta de resultados do modo de exibição usando GetFolder. O uso da pasta de resultados obtidos permite a manipulação dos dados na pasta com mais flexibilidade do que com os métodos que IExplorerBrowser fornece.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

FOLDERFLAGS

IExplorerBrowser