Interface IFolderFilter (shobjidl_core.h)

  • Artigo

Exposto por um cliente para especificar como filtrar a enumeração de uma pasta shell por um aplicativo de servidor.

Herança

A interface IFolderFilter herda da interface IUnknown . IFolderFilter também tem esses tipos de membros:

Métodos

A interface IFolderFilter tem esses métodos.

 
IFolderFilter::GetEnumFlags

Permite que um cliente especifique quais classes de objetos em uma pasta Shell devem ser enumeradas. Quando usado com SHBrowseForFolder, especifica a classe ou as classes de itens que devem ser mostradas na exibição de árvore da caixa de diálogo e qual classe ou classes não devem.
IFolderFilter::ShouldShow

Especifica se um item individual deve ser permitido por meio do filtro e qual deve ser bloqueado.

Comentários

Essa interface é usada com mais frequência com SHBrowseForFolder para filtrar o conteúdo do modo de exibição de árvore exibido em uma caixa de diálogo de seleção de pasta. Para usar IFolderFilter com SHBrowseForFolder, o sinalizador BIF_NEWDIALOGSTYLE deve ser definido.

Quando seu aplicativo chama SHBrowseForFolder, você se torna um cliente do objeto do navegador de pastas. O objeto do navegador de pastas se comunica com você enviando mensagens para uma função de retorno de chamada, BrowseCallbackProc. A mensagem BFFM_IUNKNOWN manipulada por essa função de retorno de chamada contém um ponteiro para a interface IUnknown do navegador de pastas. Para filtrar a exibição do conteúdo de uma pasta, faça o seguinte:

  1. Use o método QueryInterface do navegador de pastas para solicitar um ponteiro para a interface IFolderFilterSite .
  2. Chame IFolderFilterSite::SetFilter, passando um ponteiro para a interface IFolderFilter .
  3. O navegador de pastas consulta IFolderFilter::GetEnumFlags e IFolderFilter::ShouldShow para determinar como filtrar a enumeração.

Requisitos

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

Confira também

IFolderFilterSite