Range.StartOf, méthode (Word)

  • Article

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

Range, 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.