Range.StartOf, méthode (Word)
Déplace ou étend la position de début de la plage spécifiée ou la sélection au début de l'unité de texte spécifiée le plus proche. Cette méthode renvoie un type Long qui indique le nombre de caractères par lequel la plage ou la sélection a été déplacée ou étendue. La méthode renvoie un nombre négatif si le déplacement s'effectue vers l'arrière dans le document.
Syntaxe
expression. StartOf( _Unit_ , _Extend_ )
expression Obligatoire. Variable qui représente un objet Range.
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| Unit | Facultatif | WdUnits | L'unité à laquelle la position de début de la plage spécifiée ou la sélection doit être déplacée. Peut être une des constantes WdUnits, à l'exception de wdLine. La valeur par défaut est wdWord. |
| Extend | Facultatif | WdMovement | Spécifie s'il faut déplacer ou étendre le début de la plage. Si vous utilisez wdMove, les deux extrémités de la plage ou la sélection sont déplacées vers le début de l'unité spécifiée. Si vous utilisez wdExtend, le début de la plage ou la sélection est étendu jusqu'au début de l'unité spécifiée. La valeur par défaut est wdMove. |
Remarques
Cette méthode ne déplace, ni n'étend la plage ou la sélection indiquée si le début d'une de ces dernières se trouve déjà au début de l'unité spécifiée. Par exemple, si la sélection se trouve au début d'une ligne, l'exemple suivant renvoie la valeur 0 (zéro) et ne modifie pas la sélection.
char = Selection.StartOf(Unit:=wdLine, Extend:=wdMove)
Exemple
Cet exemple montre comment sélectionner le texte à partir du point d'insertion jusqu'au début de la ligne. Le nombre de caractères sélectionnés est stocké dans la variable charmoved.
Selection.Collapse Direction:=wdCollapseStart charmoved = Selection.StartOf(Unit:=wdLine, Extend:=wdExtend)
Cet exemple montre comment déplacer la sélection vers le début du paragraphe.
Selection.StartOf Unit:=wdParagraph, Extend:=wdMove
Cet exemple montre comment déplacer myRange au début de la deuxième phrase du document ( myRange est réduit et positionné au début de la deuxième phrase). Il montre également comment afficher l'emplacement de la variable myRange à l'aide de la méthode Select.
Set myRange = ActiveDocument.Sentences(2)
myRange.StartOf Unit:=wdSentence, Extend:=wdMove
myRange.Select
Voir aussi
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.