Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Devolve uma matriz baseada em zero que contém um subconjunto de uma matriz de cadeia com base num critério de filtro especificado.
Sintaxe
Filter(sourcearray, match, [ include, [ compare ]])
A sintaxe da função Filter tem estes argumentos nomeados:
| Sair | Descrição |
|---|---|
| matriz de origem | Obrigatório. Matriz unidimensional de cadeias a procurar. |
| corresponder | Obrigatório. Cadeia a procurar. |
| include | Opcional. Valor booleano que indica se as subcadeias que incluem ou excluem correspondem. Se incluir for Verdadeiro, Filtro devolve o subconjunto da matriz que contém a correspondência como uma subcadeia. Se incluir for Falso, Filtro devolve o subconjunto da matriz que não contém correspondência como uma subcadeia. |
| compare | Opcional. Valor numérico que indica o tipo de comparação de cadeias a utilizar. Confira a seção Configurações para obter os valores. |
Configurações
O argumento compare pode ter os seguintes valores:
| Constant | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | -1 | Executa uma comparação usando a configuração da instrução da Option Compare. |
| vbBinaryCompare | 0 | Executa uma comparação binária. |
| vbTextCompare | 1 | Executa uma comparação textual. |
| vbDatabaseCompare | 2 | Somente Microsoft Access. Executa uma comparação baseada nas informações do seu banco de dados. |
A matriz devolvida pela função Filter contém apenas elementos suficientes para conter o número de itens correspondentes.
Confira também
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.