Método Application.SetAutoFilter (Project)

  • Artigo

Define os critérios de um Filtro Automático para um campo especificado em um modo de exibição de planilha.

Sintaxe

expressão. SetAutoFilter (FieldName, FilterType, Test1, Criteria1, Operation, Test2, Criteria2)

Expressão Uma expressão que retorna um objeto Application .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
FieldName Obrigatório String Nome do campo.
FilterType Opcional PjAutoFilterType Tipo de filtro; pode ser uma das seguintes constantes PjAutoFilterType. O valor padrão é pjAutoFilterClear, que limpa o AutoFiltro.
Test1 Opcional String Especifica o tipo de comparação do primeiro teste. Exige que FilterType seja pjAutoFilterCustom e que Criteria1 especifique um valor. Pode ser uma das cadeias de caracteres de comparação.
Criteria1 Opcional String O valor da primeira comparação com o valor do campo especificado por FieldName.
Operação Opcional String A operação lógica se houver um segundo teste. O valor de Operation pode ser "And" ou "Or".
Test2 Opcional String Especifica o tipo de comparação do segundo teste. Exige que FilterType seja pjAutoFilterCustom, o valor da operação deve ser definido e que Criteria2 especifica um valor. A cadeia de caracteres pode ser uma das comparações na tabela para Test1.
Criteria2 Opcional String O valor da segunda comparação com o valor do campo especificado por FieldName.

Cadeias de caracteres de comparação

Cadeia de comparação Descrição
"é igual a" O valor de FieldName é igual a Criteria1.
"é diferente de" O valor de FieldName é diferente de Criteria1.
"é maior que" O valor de FieldName é maior que Criteria1.
"é maior que ou igual a" O valor de FieldName é maior que ou igual a Criteria1.
"é menor que" O valor de FieldName é menor que Criteria1.
"é menor que ou igual a" O valor de FieldName é menor que ou igual a Criteria1.
"está contido em" O valor de FieldName está contido em Criteria1.
"não está contido em" O valor de FieldName não está contido em Criteria1.

Valor de retorno

Boolean

Comentários

Para ativar ou desativar o recurso Filtro Automático, consulte o método AutoFilter.

Observação

Um nome de coluna em um modo de exibição de planilha pode ter um título diferente do campo que é mostrado.

Exemplo

O exemplo a seguir define um Filtro Automático personalizado para o campo "% Trabalho Concluído".

Sub TestAutoFilter() 
    If Not ActiveProject.AutoFilter Then 
        Application.AutoFilter 
    End If 
 
    Application.SetAutoFilter FieldName:="% Work Complete", FilterType:=pjAutoFilterCustom, _ 
    Test1:="equals", Criteria1:="0%" 
End Sub

Se houver um conjunto AutoFilter para o campo "% Work Complete", a linha de código a seguir desmarca o AutoFilter porque o valor padrão para o argumento FilterType opcional é pjAutoFilterClear.

Application.SetAutoFilter FieldName:="% Work Complete"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.