Selection.Extend, méthode (Word)

  • Article

Active le mode Extension et, si celui-ci est déjà activé, étend la sélection jusqu'à l'unité de texte supérieure suivante.

Syntaxe

expression. Étendre (caractère)

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

Paramètres

Nom Requis/Facultatif Type de données Description
Character Facultatif Variante Caractère jusqu'auquel la sélection est étendue. Cet argument respecte la casse et doit être évalué à une valeur De type String , sinon une erreur se produit. De plus, si la valeur de cet argument se compose de plusieurs caractères, Microsoft Word ignore la commande.

Remarques

L’utilisation de cette méthode définit la propriété ExtendMode sur la valeur True si ce n’est déjà fait.

Les niveaux des unités de texte sont les suivants : mot, phrase, paragraphe, section, puis document entier. Si Caractère est spécifié, la sélection est étendue jusqu'à la prochaine occurrence du caractère spécifié. Pour étendre la sélection, déplacez l’extrémité active de la sélection.

Exemple

Cet exemple montre comment réduire la sélection active au point d'insertion, puis sélectionner la phrase active.

With Selection 
 ' Collapse current selection to insertion point. 
 .Collapse 
 ' Turn extend mode on. 
 .Extend 
 ' Extend selection to word. 
 .Extend 
 ' Extend selection to sentence. 
 .Extend 
End With

Cet exemple montre comment réaliser la même opération sans la méthode Extend.

With Selection 
 ' Collapse current selection. 
 .Collapse 
 ' Expand selection to current sentence. 
 .Expand Unit:=wdSentence 
End With

Cet exemple montre comment activer l'extrémité de la sélection et étendre la sélection jusqu'à la prochaine occurrence de la lettre « R » majuscule.

With Selection 
 .StartIsActive = False 
 .Extend Character:="R" 
End Wit

Voir aussi

Selection, objet

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.