Método IFileDialog::SetFilter (shobjidl_core.h)

[Preterido. SetFilter não está mais disponível para uso a partir do Windows 7.]

Define o filtro.

Sintaxe

HRESULT SetFilter(
  IShellItemFilter *pFilter
);

Parâmetros

pFilter

Tipo: IShellItemFilter*

Um ponteiro para o IShellItemFilter que deve ser definido.

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

Esse método poderá ser usado se o aplicativo precisar executar filtragem especial para remover alguns itens do modo de exibição da caixa de diálogo. IncludeItem será chamado para cada item que normalmente seria incluído na exibição. GetEnumFlagsForItem não é usado. Para filtrar por tipo de arquivo, IFileDialog::SetFileTypes deve ser usado, pois em pastas com um grande número de itens, ele pode oferecer melhor desempenho do que aplicar um IShellItemFilter.

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)