Find.Execute Método

Referência

Definição

Namespace:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Operação de localização de execuções especificadas.

public bool Execute (ref object FindText, ref object MatchCase, ref object MatchWholeWord, ref object MatchWildcards, ref object MatchSoundsLike, ref object MatchAllWordForms, ref object Forward, ref object Wrap, ref object Format, ref object ReplaceWith, ref object Replace, ref object MatchKashida, ref object MatchDiacritics, ref object MatchAlefHamza, ref object MatchControl);

abstract member Execute : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> bool

Public Function Execute (Optional ByRef FindText As Object, Optional ByRef MatchCase As Object, Optional ByRef MatchWholeWord As Object, Optional ByRef MatchWildcards As Object, Optional ByRef MatchSoundsLike As Object, Optional ByRef MatchAllWordForms As Object, Optional ByRef Forward As Object, Optional ByRef Wrap As Object, Optional ByRef Format As Object, Optional ByRef ReplaceWith As Object, Optional ByRef Replace As Object, Optional ByRef MatchKashida As Object, Optional ByRef MatchDiacritics As Object, Optional ByRef MatchAlefHamza As Object, Optional ByRef MatchControl As Object) As Boolean

Parâmetros

FindText: Object

Objetoopcional. O texto a ser localizado. Use uma cadeia de caracteres vazia ("") para procurar somente a 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 tabulação.

MatchCase: Object

Objetoopcional. 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" (menu Editar).

MatchWholeWord: Object

Objetoopcional. True para que a operação de localização Localize apenas palavras inteiras, e não o texto que faz parte de uma palavra maior. Corresponde à caixa de seleção "Localizar apenas palavras inteiras", na caixa de diálogo "Localizar e substituir".

MatchWildcards: Object

Objetoopcional. 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: Object

Objetoopcional. 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: Object

Objetoopcional. 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.

Forward: Object

Objetoopcional. True para pesquisa registros posteriores (até o final do documento).

Wrap: Object

Objetoopcional. Controla o que acontece se a pesquisa começa em um ponto que não o início do documento e o final do documento é alcançado (ou vice-versa, se Forward estiver definido como false). Esse argumento também controla o que acontece se houver uma seleção ou intervalo e o texto de pesquisa não for encontrado na seleção ou no intervalo. Pode ser uma das seguintes WdFindWrap constantes:wdFindAsk após pesquisar a seleção ou o intervalo, o Microsoft Word exibe uma mensagem perguntando se deseja pesquisar o restante do documento. wdFindContinue a operação de localização continuará se o início ou o fim do intervalo de pesquisa for atingido. wdFindStop A operação de localização termina se o início ou o fim do intervalo de pesquisa for atingido.

Format: Object

Objetoopcional. True para que a operação de localizar encontre formatação além ou em vez do texto de localização.

ReplaceWith: Object

Objetoopcional. O texto de substituição. Para excluir o texto especificado pelo Find argumento, use uma cadeia de caracteres vazia (""). Você especifica caracteres especiais e critérios de pesquisa avançados da mesma forma como faria para o Find argumento. Para especificar um objeto gráfico ou outro item que não seja de texto como a substituição, mova o item para a área de transferência e especifique "^ c" para o ReplaceWith .

Replace: Object

Objetoopcional. Especifica quantas substituições devem ser feitas: uma, todas ou nenhuma. Pode ser qualquer WdReplace constante:wdReplaceAll wdReplaceNone wdReplaceOne

MatchKashida: Object

Objetoopcional. True se localizar operações coincidirem texto com correspondência de kashidas em um documento de idioma árabe. Esse argumento pode não estar disponível para você, dependendo do suporte a idioma (português do Brasil, por exemplo) que tiver sido selecionado ou instalado.

MatchDiacritics: Object

Objetoopcional. True se as operações de localização coincidirem texto com diacrítico em um documento da direita para a esquerda. Esse argumento pode não estar disponível para você, dependendo do suporte a idioma (português do Brasil, por exemplo) que tiver sido selecionado ou instalado.

MatchAlefHamza: Object

Objetoopcional. True se localizar operações coincidirem texto com alef hamzas em um documento de idioma árabe coincidentes. Esse argumento pode não estar disponível para você, dependendo do suporte a idioma (português do Brasil, por exemplo) que tiver sido selecionado ou instalado.

MatchControl: Object

Objetoopcional. 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. Esse argumento pode não estar disponível para você, dependendo do suporte a idioma (português do Brasil, por exemplo) que tiver sido selecionado ou instalado.

Retornos

Boolean

Comentários

Este método retornará true se a operação de localização for bem-sucedida.

Se MatchWildcards for true, você poderá especificar os caracteres curinga e outros critérios de pesquisa avançada para o FindText argumento. Por exemplo, "* (er)" encontra qualquer palavra que termina em "er".

Para procurar um caractere de símbolo, digite um acento circunflexo (^), um zero (0) e, em seguida, o código de caractere do símbolo. Por exemplo, "^ 0151" corresponde a um travessão (-).

A menos que seja especificado algo em contrário, o texto de substituição herda a formatação do texto que ele substitui no documento. Por exemplo, se você substituir a cadeia de caracteres "ABC" por "XYZ", as ocorrências de "ABC" com formatação negrito serão substituídas pela cadeia de caracteres "XYZ" com formatação negrito.

Além disso, se MatchCase for falso, as ocorrências do texto de pesquisa que estão em maiúsculas serão substituídas por uma versão em maiúsculas do texto de substituição, independentemente da caixa de texto de pesquisa e substituição. Usando o exemplo anterior, as ocorrências de "ABC" são substituídas por "XYZ".

Aplica-se a