Método Find (VBA Add-In Object Model)
Pesquisa o módulo ativo para obter uma cadeia de caracteres especificada.
Sintaxe
objeto. Localizar (target, startline, startcol, endline, endcol, [ wholeword ], [ matchcase ], [ patternsearch ]) Como booliano
A sintaxe Localizar tem estas partes:
Sair | Descrição |
---|---|
objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
target | Obrigatório. Uma Cadeia de Caracteres que contém o texto ou o padrão que você deseja encontrar. |
Startline | Obrigatório. Um Long especificando a linha na qual você deseja iniciar a pesquisa; será definido como a linha da correspondência se um for encontrado. A primeira linha é o número 1. |
startcol | Obrigatório. Um Long especificando a coluna na qual você deseja iniciar a pesquisa; será definido como a coluna que contém a correspondência se um for encontrado. A primeira coluna é 1. |
Endline | Obrigatório. Um Long especificando a última linha da correspondência se uma for encontrada. A última linha pode ser especificada como -1. |
endcol | Obrigatório. Um Long especificando a última linha da correspondência se uma for encontrada. A última coluna pode ser designada como -1. |
palavra inteira | Opcional. Um valor booliano que especifica se deve corresponder apenas a palavras inteiras. Se True, corresponde apenas a palavras inteiras. False é o padrão. |
Matchcase | Opcional. Um valor booliano que especifica se deve corresponder ao caso. Se True, a pesquisa é sensível a casos. False é o padrão. |
patternsearch | Opcional. Um valor booliano que especifica se a cadeia de caracteres de destino é ou não um padrão, que pode conter caracteres curinga, como um asterisco (*) ou um ponto de interrogação (?). Se True, a cadeia de caracteres de destino será um padrão. False é o padrão. |
Comentários
Localizar retorna True se uma correspondência for encontrada e False se uma correspondência não for encontrada.
Os argumentos matchcase e patternsearch são mutuamente exclusivos; se ambos os argumentos forem passados como True, ocorrerá um erro.
O conteúdo da caixa de diálogo Localizar não é afetado pelo método Localizar .
O intervalo especificado de linhas e colunas é inclusivo, portanto, uma pesquisa pode encontrar o padrão na última linha especificada se o endcol for fornecido como -1 ou o comprimento da linha.
Confira também
- Coleções (Visual Basic Add-In Model)
- Referência de modelo de suplemento do Visual Basic
- Referência de linguagem do Visual Basic
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.