Méthode Find.Execute (Word)

  • Article

Exécute l’opération de recherche spécifiée. Renvoie la valeur True si l’opération a été effectuée avec succès. Valeur booléenne.

Syntaxe

expression. Execute (FindText, MatchCase, MatchWholeWord, MatchWildcards, MatchSoundsLike, MatchAllWordForms, Forward, Wrap, Format, ReplaceWith, Replace, MatchKashida, MatchDiacritics, MatchAlefHamza, MatchControl)

expression Obligatoire. Variable qui représente un objet Find.

Parameters

Nom Requis/Facultatif Type de données Description
FindText Facultatif Variant Texte à rechercher. Utilisez une chaîne vide ("") pour rechercher la mise en forme uniquement. Vous pouvez rechercher des caractères spéciaux en spécifiant les codes de caractère appropriés. Par exemple, « ^p » correspond à une marque de paragraphe et « ^t » correspond à un caractère de tabulation.
MatchCase Facultatif Variant True pour spécifier que le texte à rechercher est sensible à la casse. Correspond à la case à cocher Respecter la casse de la boîte de dialogue Rechercher et remplacer (menu Édition).
MatchWholeWord Facultatif Variant True pour que l'opération de recherche rechercher uniquement des mots entiers et non du texte qui fait partie d'un mot. Correspond à la case à cocher mot entier dans la boîte de dialogue Rechercher et remplacer.
MatchWildcards Facultatif Variant True pour que le texte à rechercher soit un opérateur de recherche spécial. Correspond à la case à cocher utiliser les caractères génériques dans la boîte de dialogue Rechercher et remplacer.
MatchSoundsLike Facultatif Variant True pour que l'opération de recherche s'effectue sur les mots similaires au texte à rechercher. Correspond à la case à cocher Recherche phonétique dans la boîte de dialogue Rechercher et remplacer.
MatchAllWordForms Facultatif Variant True pour que l'opération de recherche s'effectue sur toutes les formes du texte à rechercher (par exemple, « sit » recherche « assis » et « assis »). Correspond à la case à cocher Rechercher toutes les formes du mot dans la boîte de dialogue Rechercher et remplacer.
Forward Facultatif Variant True pour rechercher l'occurrence suivante (vers la fin du document).
Wrap Facultatif Variant Contrôle ce qui se produit si la recherche commence à un point autre que le début du document et que la fin du document est atteinte (ou vice versa si l’option Avancer a la valeur False). Cet argument contrôle également ce qui se produit s’il existe une sélection ou une plage et que le texte à rechercher est introuvable dans la sélection ou dans la plage. Il peut s’agir de l’une des constantes WdFindWrap .
Format Facultatif Variant True pour que l’opération de recherche s’effectue sur toutes les formes en plus ou à la place du mot à rechercher.
ReplaceWith Facultatif Variant Texte de remplacement. Pour supprimer le texte spécifié par l'argument Rechercher, utilisez une chaîne vide (""). Vous spécifiez des caractères spéciaux et des critères de recherche avancée de la même manière que vous utilisez l'argument Rechercher. Pour spécifier un objet graphique ou un élément non-texte en tant qu'élément de remplacement, placez cet élément dans le Presse-papiers, et spécifiez « ^c » pour RemplacerPar.
Replace Facultatif Variant Spécifie le nombre de remplacements à effectuer : un, tous ou aucun. Il peut s’agir de n’importe quelle constante WdReplace .
MatchKashida Facultatif Variant La valeur True si recherche mettent en correspondance le texte des signes kachidés dans un document en langue arabe. Cet argument n'est peut-être pas disponible, en fonction de la prise en charge de langue (anglais (États-Unis), par exemple) que vous avez sélectionnée ou installée.
MatchDiacritics Facultatif Variant La valeur True si recherche mettent en correspondance le texte en signes diacritiques dans un document en langue de droite à gauche. Cet argument n'est peut-être pas disponible, en fonction de la prise en charge de langue (anglais (États-Unis), par exemple) que vous avez sélectionnée ou installée.
MatchAlefHamza Facultatif Variant La valeur True si recherche mettent en correspondance le texte en signes alef hamza dans un document en langue arabe. Cet argument n'est peut-être pas disponible, en fonction de la prise en charge de langue (anglais (États-Unis), par exemple) que vous avez sélectionnée ou installée.
MatchControl Facultatif Variant La valeur True si recherche mettent en correspondance le texte en caractères de contrôle bidirectionnels dans un document en langue de droite à gauche. Cet argument ne sera peut-être pas disponible, en fonction de la langue sélectionnée ou installée (par exemple, le français).
MatchPrefix Facultatif Variant True pour faire correspondre les mots commençant par la chaîne de recherche. Correspond à la case à cocher préfixe dans la boîte de dialogue Rechercher et remplacer.
MatchSuffix Facultatif Variant True pour faire correspondre les mots se terminant par la chaîne de recherche. Correspond à la case à cocher suffixe dans la boîte de dialogue Rechercher et remplacer.
MatchPhrase Facultatif Variant True pour ignorer les espaces et les caractères de contrôle situés entre les mots.
IgnoreSpace Facultatif Variant True ignore tous les espaces entre les mots. Correspond à la case à cocher Ignorer les caractères d'espace blanc dans la boîte de dialogue Rechercher et remplacer.
IgnorePunct Facultatif Variant True ignore tous les caractères de ponctuation entre les mots. Correspond à la case Ignorer les marques de ponctuation de la boîte de dialogue Rechercher et remplacer.

Valeur renvoyée

Booléen

Remarques

Si MatchWildcards a la valeur True, vous pouvez spécifier des caractères génériques et d’autres critères de recherche avancée pour l’argument FindText. Par exemple, « *(ant) » recherche tous les mots se terminant par « ant ».

Pour rechercher un symbole, tapez le signe (^) suivi d'un zéro (0), puis le code de caractère du symbole. Par exemple, « ^0151 » correspond à un tiret cadratin (—).

À moins que ce soit spécifié, le texte de remplacement hérite du format du texte qu'il remplace dans le document. Par exemple, si vous remplacez la chaîne « abc » par « xyz », les occurrences de « abc » en gras sont remplacées par la chaîne « xyz » en gras.

De plus, si MatchCase a la valeur False, les occurrences du texte à rechercher qui sont en majuscules sont remplacées par une version en majuscules du texte de remplacement, et ce indépendamment de la casse du texte de remplacement. Sur la base de l’exemple précédent, les occurrences de « ABC » sont remplacées par « XYZ ».

Exemple

Cet exemple montre comment rechercher, puis sélectionner l'occurrence suivante du mot « library ».

With Selection.Find 
    .ClearFormatting 
    .MatchWholeWord = True 
    .MatchCase = False 
    .Execute FindText:="library" 
End With

Cet exemple montre comment rechercher l'ensemble des occurrences du mot « hi » dans le document actif et les remplacer toutes par « hello ».

Set myRange = ActiveDocument.Content 
myRange.Find.Execute FindText:="hi", _ 
    ReplaceWith:="hello", Replace:=wdReplaceAll

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.