Método ICommDlgBrowser::IncludeObject (shobjidl_core.h)

Permite que a caixa de diálogo comum filtre objetos exibidos pelo modo de exibição.

Sintaxe

HRESULT IncludeObject(
  IShellView      *ppshv,
  PCUITEMID_CHILD pidl
);

Parâmetros

ppshv

Tipo: IShellView*

Um ponteiro para a interface IShellView da exibição.

pidl

Tipo: LPCITEMIDLIST

Um PIDL, relativo à pasta , que identifica o objeto .

Retornar valor

Tipo: HRESULT

O navegador deve retornar S_OK para incluir o objeto no modo de exibição ou S_FALSE para ocultá-lo.

Comentários

Esse método é chamado pela implementação IEnumIDList quando hospedado em caixas de diálogo de arquivo. O enumerador chama esse método para permitir que a caixa de diálogo comum filtre objetos que não devem ser exibidos. Normalmente, as caixas de diálogo de arquivo receberão o texto de exibição do item e serão filtradas pela extensão.

Observação aos aplicativos de chamada

Ao lidar com fontes de dados que têm muitos itens, como bibliotecas e pesquisas, o retorno de chamada para esse método resulta em baixo desempenho. Para evitar essa situação, implemente GetViewFlags e retorne CDB2GVF_NOINCLUDEITEM. Isso permite que a exibição ignore a chamada de ICommDlgBrowser::IncludeObject, melhorando assim o desempenho.

Requisitos

Confira também

Exemplo de pesquisa do navegador do Explorer

ICommDlgBrowser