Share via

Método Find.HitHighlight (Word)

  • Artigo

Realça todas as correspondências localizadas e retorna um Boolean que indica se as correspondências foram localizadas.

Sintaxe

expressão. HitHighlight (FindText, HighlightColor, TextColor, MatchCase, MatchWholeWord, MatchPrefix, MatchSuffix, MatchPhrase, MatchWildcards, MatchSoundsLike, MatchAllWordForms, MatchByte, MatchFuzzy, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl, IgnoreSpace, IgnorePunct, HanjaPhoneticHangul)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
FindText Obrigatório Variant O texto a ser localizado. Use uma cadeia de caracteres vazia ("") para procurar somente pela formatação. Você pode procurar caracteres especiais especificando os códigos de caracteres apropriados. Por exemplo, "^p" corresponde a uma marca de parágrafo e "^t" corresponde a um caractere de guia.
Highlightcolor Opcional Variant Especifica a cor de realce do texto. Pode ser qualquer cor RGB ou uma das constantes WdColor.
TextColor Opcional Variant Especifica a cor do texto. Pode ser qualquer cor RGB ou uma das constantes WdColor.
MatchCase Opcional Variant True para especificar que o texto a ser diferencia maiúsculas de minúsculas. Corresponde à caixa de seleção Diferenciar maiúsculas de minúsculas, na caixa de diálogo Localizar e substituir.
MatchWholeWord Opcional Variant True para que a operação "localizar" obtenha somente palavras inteiras, e não texto que faça parte de uma palavra maior. Corresponde à caixa de seleção somente palavras inteiras na caixa de diálogo Localizar e substituir.
MatchPrefix Opcional Variant True para corresponder palavras que comecem com a cadeia de caracteres da pesquisa. Corresponde à caixa de seleção Coincidir prefixo na caixa de diálogo Localizar e substituir.
MatchSuffix Opcional Variant True para corresponder palavras que terminem com a cadeia de caracteres da pesquisa. Corresponde à caixa de seleção Coincidir sufixo na caixa de diálogo Localizar e substituir.
MatchPhrase Opcional Variant True ignora todos os espaços em branco e caracteres de controle entre as palavras.
MatchWildcards Opcional Variant True para que localizar texto seja um operador especial de pesquisa. Corresponde à caixa de seleção usar caracteres curinga na caixa de diálogo Localizar e substituir.
MatchSoundsLike Opcional Variant True para que a operação de localizar obtenha palavras semelhantes ao texto de localização. Corresponde à caixa de seleção semelhantes na caixa de diálogo Localizar e substituir.
MatchAllWordForms Opcional Variant True para que a operação "localizar" obtenha todas as formas de localizar texto (por exemplo, "sentar" localiza "sentado" e "sentou"). Corresponde à caixa de seleção todas as formas na caixa de diálogo Localizar e substituir.
MatchByte Opcional Variant True para distinguir entre caracteres ou letras de largura total e largura média durante uma pesquisa.
MatchFuzzy Opcional Variant True para usar as opções de pesquisa não específica para texto em japonês durante uma pesquisa. Leitura/gravação.
MatchKashida Opcional Variant True se as operações de localização coincidirem texto com kashidas em um documento do idioma árabe. Este argumento pode não estar disponível, dependendo do suporte a idioma (inglês americano, por exemplo) que você selecionou ou instalou.
MatchDiacritics Opcional Variant True se as operações de localização coincidirem texto com diacrítico em um documento da direita para a esquerda. Este argumento pode não estar disponível, dependendo do suporte a idioma (inglês americano, por exemplo) que você selecionou ou instalou.
MatchAlefHamza Opcional Variant True se as operações de localização coincidirem texto com Alef Hamzas em um documento do idioma árabe. Este argumento pode não estar disponível, dependendo do suporte a idioma (inglês americano, por exemplo) que você selecionou ou instalou.
MatchControl Opcional Variant True se localizar operações coincidirem texto com correspondência de caracteres de controle bidirecionais em um documento de idioma da direita para a esquerda. Este argumento pode não estar disponível, dependendo do suporte a idioma (inglês americano, por exemplo) que você selecionou ou instalou.
IgnoreSpace Opcional Variant True ignora todos os espaços em branco entre as palavras. Corresponde à caixa de seleção Ignorar caracteres de espaço em branco na caixa de diálogo Localizar e substituir.
IgnorePunct Opcional Variant True ignora todos os caracteres de pontuação entre as palavras. Corresponde à caixa de seleção Ignorar pontuação, na caixa de diálogo Localizar e substituir.
HanjaPhoneticHangul Opcional Variant True ignora os caracteres fonéticos de hangul e hanja. Disponível somente se você tiver suporte para idiomas coreanos.

Valor de retorno

Booliano

Comentários

O método HitHighlight aplica-se principalmente ao realce de pesquisa no Office Outlook quando o Word é especificado como o editor de email. No entanto, você pode usar esse método em documentos do Word dentro do se você quiser realçar o texto localizado. Caso contrário, use o método Execute.

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.