Devolve uma matriz baseada em zero contendo um subconjunto de uma matriz de cadeias baseada num critério de filtro.
Sintaxe
Filtro(matrizdeorigem, correspondência [, incluir ] [, comparar ] )
A sintaxe da função Filtro tem os seguintes argumentos (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.):
| Argumento |
Descrição |
| matrizdeorigem |
Obrigatório. Matriz unidimensional de cadeias a procurar. |
| correspondência |
Obrigatório. Cadeia a procurar. |
| incluir |
Opcional. Valor Booleano que indica se são devolvidas as subcadeias que incluem ou excluem correspondência. Se incluir for Verdadeiro, o Filtro devolve o subconjunto da matriz que contém a correspondência como uma subcadeia. Se incluir for Falso, o Filtro devolve o subconjunto da cadeia que não contém a correspondência como uma subcadeia. |
| comparar |
Opcional. Valor numérico que indica qual o tipo de comparação de cadeias a utilizar. Consulte a secção Definições para obter os valores. |
Definições
O argumento comparar pode ter os seguintes valores:
| Constante |
Valor |
Descrição |
| vbUseCompareOption |
–1 |
Efectua uma comparação utilizando a definição da instrução ComparaçãoDaOpção. |
| vbBinaryCompare |
0 |
Efectua uma comparação binária. |
| vbTextCompare |
1 |
Efectua uma comparação textual. |
| vbDatabaseCompare |
2 |
Só para o Microsoft Office Access 2007. Efectua um comparação baseada nas informações existentes na base de dados. |
Observações
Se não forem encontradas correspondências de correspondência na matrizdeorigem, o Filtro devolve uma matriz vazia. Ocorre um erro se matrizdeorigem for Nulo ou se não for uma matriz unidimensional.
A matriz devolvida pela função Filtro contém apenas os elementos suficientes para conter o número de itens correspondentes.