Método Find.Execute (Word)
Operación de búsqueda se ejecuta especificado. Devuelve True si la operación de búsqueda se realiza con éxito. Booleano.
Sintaxis
expresión. Execute (FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike, MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl)
expresión requerida. Variable que representa un objeto Find.
Parameters
Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
---|---|---|---|
FindText | Opcional | Variant | 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 | Opcional | Variant | 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 | Opcional | Variant | True para que la operación busque sólo palabras completas y no texto que forme parte de una palabra más grande. Corresponde a la casilla de verificación sólo palabras completas en el cuadro de diálogo Buscar y reemplazar. |
MatchWildcards | Opcional | Variant | True para que la búsqueda de texto sea un operador de búsqueda especial. Corresponde a la casilla de verificación usar caracteres comodín en el cuadro de diálogo Buscar y reemplazar. |
MatchSoundsLike | Opcional | Variant | 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 | Opcional | Variant | 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 | Opcional | Variant | True para buscar hacia adelante (hacia el final del documento). |
Wrap | Opcional | Variant | Controla lo que sucede si la búsqueda se inicia en otro punto que no sea el comienzo del documento y se alcanza el final del documento (o viceversa si Forward está establecido en False). Este argumento controla además lo que sucede si hay una selección o un intervalo y no se puede encontrar el texto de búsqueda en la selección o el intervalo. Puede ser una de las constantes WdFindWrap . |
Format | Opcional | Variant | True para hacer que la operación de búsqueda encuentre formato además de, o en lugar de, el texto de búsqueda. |
ReplaceWith | Opcional | Variant | Texto de reemplazo. Para eliminar el texto especificado por el argumento Find, se debe usar una cadena vacía (""). Los caracteres especiales y los criterios de búsqueda avanzada se especifican del mismo modo que el argumento Find. Para especificar un objeto gráfico u otro elemento que no sea de texto como el reemplazo, se debe mover el elemento al Portapapeles y especificar "^c" en ReplaceWith. |
Replace | Opcional | Variant | Especifica cuántos reemplazos se efectuarán: uno, todos o ninguno. Puede ser cualquier constante WdReplace . |
MatchKashida | Opcional | Variant | 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 que haya seleccionado o instalado (por ejemplo, inglés, Estados Unidos). |
MatchDiacritics | Opcional | Variant | 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 que haya seleccionado o instalado (por ejemplo, inglés, Estados Unidos). |
MatchAlefHamza | Opcional | Variant | 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 que haya seleccionado o instalado (por ejemplo, inglés, Estados Unidos). |
MatchControl | Opcional | Variant | 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, dependiendo de la compatibilidad de idioma (por ejemplo, inglés, Estados Unidos) que haya seleccionado o instalado. |
MatchPrefix | Opcional | Variant | True para que coincida con las palabras que comienzan con la cadena de búsqueda. Corresponde a la casilla de verificación prefijo en el cuadro de diálogo Buscar y reemplazar. |
MatchSuffix | Opcional | Variant | True para que coincida con las palabras que terminan con la cadena de búsqueda. Corresponde a la casilla de verificación sufijo en el cuadro de diálogo Buscar y reemplazar. |
MatchPhrase | Opcional | Variant | True omite todos los espacios en blanco y caracteres de control entre palabras. |
IgnoreSpace | Opcional | Variant | True omite todos los espacios blanco entre palabras. Corresponde a la casilla de verificación Omitir espacios en blanco en el cuadro de diálogo Buscar y reemplazar. |
IgnorePunct | Opcional | Variant | True omite todos los caracteres de puntuación. Corresponde a la casilla Ignorar puntuación en el cuadro de diálogo Buscar y reemplazar. |
Valor devuelto
Booleano
Comentarios
Si MatchWildcards está en True, se pueden especificar los caracteres comodín y otros criterios de búsqueda avanzada para el argumento FindText. Por ejemplo, "* (ADO)" busca todas las palabras que terminen en "ADO".
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 largo (—).
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 se reemplaza la cadena "abc" con "xyz", las coincidencias de "abc" con formato de negrita serán reemplazadas con la cadena "xyz" con formato de negrita.
También, si MatchCase está en False, las coincidencias del texto de búsqueda que estén en mayúscula serán reemplazadas con una versión en mayúscula del texto de reemplazo independientemente de que el texto de reemplazo estén en mayúscula o en minúscula. Siguiendo con el ejemplo anterior, las coincidencias de "ABC" serán reemplazadas con "XYZ".
Ejemplo
En este ejemplo, se busca y se selecciona la siguiente coincidencia de la palabra "biblioteca".
With Selection.Find
.ClearFormatting
.MatchWholeWord = True
.MatchCase = False
.Execute FindText:="library"
End With
En este ejemplo se buscan todas las coincidencias de la palabra "buenas" del documento activo y se reemplaza cada coincidencia con la palabra "hola".
Set myRange = ActiveDocument.Content
myRange.Find.Execute FindText:="hi", _
ReplaceWith:="hello", Replace:=wdReplaceAll
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de