Find.Execute Método

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

Objeto opcional. 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

Objeto opcional. 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

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

MatchWildcards

Object

Objeto opcional. 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

Objeto opcional. 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

Objeto opcional. 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

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

Wrap

Object

Objeto opcional. Controla o que acontece se a pesquisa começar em um ponto diferente do início do documento e o final do documento for atingido (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 intervalo. Pode ser uma das seguintes WdFindWrap constantes:wdFindAsk Depois de pesquisar a seleção ou o intervalo, o Microsoft Word exibe uma mensagem perguntando se deve 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 terminará se o início ou o fim do intervalo de pesquisa for atingido.

Format

Object

Objeto opcional. True para que a operação localizar localize a formatação, além ou em vez do texto de localização.

ReplaceWith

Object

Objeto opcional. 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 avançados de pesquisa, assim como faz 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 ReplaceWith.

Replace

Object

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

MatchKashida

Object

Objeto opcional. 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

Objeto opcional. 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

Objeto opcional. 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

Objeto opcional. 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

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

Se MatchWildcards for True, você pode especificar caracteres curinga e outros critérios avançados de pesquisa para o FindText argumento. Por exemplo, "*(ing)" encontra qualquer palavra que termine em "ing".

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 traço em (— ).

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 em negrito serão substituídas pela cadeia de caracteres "xyz" por formatação em negrito.

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