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.