Find.Execute Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Opération de recherche spécifié s'exécute.
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
Paramètres
- FindText
- Object
Objet facultatif. 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
- Object
Objet facultatif. 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
- Object
Objet facultatif. True pour que l’opération de recherche recherche recherche uniquement des mots entiers, et non du texte qui fait partie d’un mot plus grand. Correspond à la case à cocher Mot entier de la boîte de dialogue Rechercher et remplacer.
- MatchWildcards
- Object
Objet facultatif. True pour que le texte à rechercher soit un opérateur de recherche spécial. Correspond à la case Caractères génériques de la boîte de dialogue Rechercher et remplacer.
- MatchSoundsLike
- Object
Objet facultatif. 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
- Object
Objet facultatif. 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
- Object
Objet facultatif. True pour rechercher l'occurrence suivante (vers la fin du document).
- Wrap
- Object
Objet facultatif. Contrôle ce qui se passe si la recherche commence à un point autre que le début du document et que la fin du document est atteinte (ou inversement si Forward
a la valeur False). Cet argument contrôle également ce qui se passe s’il existe une sélection ou une plage et que le texte de recherche est introuvable dans la sélection ou la plage. Il peut s’agir de l’une des constantes suivantes WdFindWrap :wdFindAsk Après avoir effectué une recherche dans la sélection ou la plage, Microsoft Word affiche un message vous demandant s’il faut effectuer une recherche dans le reste du document.wdFindContinue L’opération de recherche se poursuit si le début ou la fin de la plage de recherche est atteint. wdFindStop L’opération de recherche se termine si le début ou la fin de la plage de recherche est atteint.
- Format
- Object
Objet facultatif. True pour que l’opération de recherche localise la mise en forme en plus ou au lieu du texte de recherche.
- ReplaceWith
- Object
Objet facultatif. Texte de remplacement. Pour supprimer le texte spécifié par l’argument Find
, utilisez une chaîne vide (« »). Vous spécifiez des caractères spéciaux et des critères de recherche avancés comme vous le faites pour l’argument Find
. Pour spécifier un objet graphique ou un autre élément non textuel comme remplacement, déplacez l’élément dans le Presse-papiers et spécifiez « ^c » pour ReplaceWith
.
- Replace
- Object
Objet facultatif. Spécifie le nombre de remplacements à effectuer : un, tous ou aucun. Peut être n’importe quelle WdReplace constante :wdReplaceAll wdReplaceNone wdReplaceOne
- MatchKashida
- Object
Objet facultatif. La valeur True si recherche mettent en correspondance le texte des signes kachidés dans un document en langue arabe. Il se peut que cet argument ne soit pas disponible, selon la prise en charge de langue (anglais (États-Unis) par exemple) que vous avez sélectionnée ou installée.
- MatchDiacritics
- Object
Objet facultatif. La valeur True si recherche mettent en correspondance le texte en signes diacritiques dans un document en langue de droite à gauche. Il se peut que cet argument ne soit pas disponible, selon la prise en charge de langue (anglais (États-Unis) par exemple) que vous avez sélectionnée ou installée.
- MatchAlefHamza
- Object
Objet facultatif. La valeur True si recherche mettent en correspondance le texte en signes alef hamza dans un document en langue arabe. Il se peut que cet argument ne soit pas disponible, selon la prise en charge de langue (anglais (États-Unis) par exemple) que vous avez sélectionnée ou installée.
- MatchControl
- Object
Objet facultatif. 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. Il se peut que cet argument ne soit pas disponible, selon la prise en charge de langue (anglais (États-Unis) par exemple) que vous avez sélectionnée ou installée.
Retours
Remarques
Cette méthode retourne True si l’opération de recherche réussit.
Si MatchWildcards
a la valeur True, vous pouvez spécifier des caractères génériques et d’autres critères de recherche avancés pour l’argument FindText
. Par exemple, « *(ing) » recherche tout mot qui se termine par « ing ».
Pour rechercher un caractère de symbole, tapez un accent circonflexe (^), un zéro (0), puis le code de caractère du symbole. Par exemple, « ^0151 » correspond à un tiret em (— ).
À 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 » avec mise en forme en gras sont remplacées par la chaîne « xyz » par la mise en forme en gras.
En outre, si MatchCase
a la valeur False, les occurrences du texte de recherche qui sont en majuscules sont remplacées par une version majuscule du texte de remplacement, quelle que soit la casse du texte de recherche et de remplacement. À l’aide de l’exemple précédent, les occurrences de « ABC » sont remplacées par « XYZ ».