Find.Execute Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Operación de búsqueda se ejecuta especificado.
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. El texto que se va a buscar. Para buscar sólo formato se debe usar una cadena vacía (""). Para buscar caracteres especiales se deben especificar los códigos de caracteres apropiados. Por ejemplo, "^p" corresponde a una marca de párrafo y "^t" corresponde a un carácter de tabulación.
- MatchCase
- Object
Objeto opcional. True para especificar que el texto de búsqueda distingue mayúsculas de minúsculas. Corresponde a la casilla Coincidir mayúsculas y minúsculas en el cuadro de diálogo Buscar y reemplazar (menú Edición).
- MatchWholeWord
- Object
Objeto opcional. True para que la operación de búsqueda busque solo palabras completas, no texto que forme parte de una palabra mayor. Corresponde a la casilla Solo palabras completas en el cuadro de diálogo Buscar y reemplazar.
- MatchWildcards
- Object
Objeto opcional. True para que la búsqueda de texto sea un operador de búsqueda especial. Corresponde a la casilla Usar caracteres comodín en el cuadro de diálogo Buscar y reemplazar.
- MatchSoundsLike
- Object
Objeto opcional. True para que la operación de búsqueda localice palabras que suenen de forma similar a la búsqueda de texto. Corresponde a la casilla de verificación Suena como en el cuadro de diálogo Buscar y reemplazar.
- MatchAllWordForms
- Object
Objeto opcional. True para que la operación de búsqueda localice todas las formas de la búsqueda de texto ("por ejemplo, sit" localiza "sentado" y "sat"). Corresponde a la casilla de verificación todas las formas de word en el cuadro de diálogo Buscar y reemplazar.
- Forward
- Object
Objeto opcional. True para buscar hacia adelante (hacia el final del documento).
- Wrap
- Object
Objeto opcional. Controla lo que sucede si la búsqueda comienza en un punto distinto del principio del documento y se alcanza el final del documento (o viceversa si Forward
se establece en False). Este argumento también controla lo que sucede si hay una selección o un intervalo y el texto de búsqueda no se encuentra en la selección o el intervalo. Puede ser una de las siguientes WdFindWrap constantes:wdFindAsk Después de buscar en la selección o el intervalo, Microsoft Word muestra un mensaje que pregunta si desea buscar en el resto del documento.wdFindContinue La operación de búsqueda continúa si se alcanza el principio o el final del intervalo de búsqueda. wdFindStop La operación de búsqueda finaliza si se alcanza el principio o el final del intervalo de búsqueda.
- Format
- Object
Objeto opcional. True para que la operación de búsqueda busque el formato además de o en lugar del texto de búsqueda.
- ReplaceWith
- Object
Objeto opcional. Texto de reemplazo. Para eliminar el texto especificado por el Find
argumento , use una cadena vacía (""). Los caracteres especiales y los criterios de búsqueda avanzados se especifican igual que para el Find
argumento . Para especificar un objeto gráfico u otro elemento que no sea de texto como reemplazo, mueva el elemento al Portapapeles y especifique "^c" para ReplaceWith
.
- Replace
- Object
Objeto opcional. Especifica cuántos reemplazos se efectuarán: uno, todos o ninguno. Puede ser cualquier WdReplace constante:wdReplaceAll wdReplaceNone wdReplaceOne
- MatchKashida
- Object
Objeto opcional. True si las operaciones buscan texto que coincida con kashidas en un documento en árabe. Este argumento puede no estar disponible, según la compatibilidad con el idioma, por ejemplo, inglés (EE.UU.), que se haya seleccionado o instalado.
- MatchDiacritics
- Object
Objeto opcional. True si las operaciones buscan texto que coincida con diacríticos en un documento de idioma de derecha a izquierda. Este argumento puede no estar disponible, según la compatibilidad con el idioma, por ejemplo, inglés (EE.UU.), que se haya seleccionado o instalado.
- MatchAlefHamza
- Object
Objeto opcional. True si las operaciones buscan texto que coincida con alif hamzas en un documento en árabe. Este argumento puede no estar disponible, según la compatibilidad con el idioma, por ejemplo, inglés (EE.UU.), que se haya seleccionado o instalado.
- MatchControl
- Object
Objeto opcional. True si las operaciones buscan texto que coincida con caracteres de control bidireccional en un documento de idioma de derecha a izquierda. Este argumento puede no estar disponible, según la compatibilidad con el idioma, por ejemplo, inglés (EE.UU.), que se haya seleccionado o instalado.
Devoluciones
Comentarios
Este método devuelve True si la operación de búsqueda se realiza correctamente.
Si MatchWildcards
es True, puede especificar caracteres comodín y otros criterios de búsqueda avanzada para el FindText
argumento . Por ejemplo, "*(ing)" busca cualquier palabra que termine en "ing".
Para buscar un carácter de símbolo, escriba un símbolo de intercalación (^), un cero (0) y, a continuación, el código de carácter del símbolo. Por ejemplo, "^0151" corresponde a un guión em (— ).
A menos que se especifique lo contrario, el texto de reemplazo hereda el formato del texto que está reemplazando en el documento. Por ejemplo, si reemplaza la cadena "abc" por "xyz", las repeticiones de "abc" con formato de negrita se reemplazan por la cadena "xyz" por formato de negrita.
Además, si MatchCase
es False, las repeticiones del texto de búsqueda que están en mayúsculas se reemplazarán por una versión en mayúsculas del texto de reemplazo, independientemente del caso del texto de búsqueda y de reemplazo. Con el ejemplo anterior, las repeticiones de "ABC" se reemplazan por "XYZ".