ITextSelection.HomeKey(TextRangeUnit, Boolean) 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.
Déplace le point d’insertion ou la fin active de la sélection de texte vers la position d’accueil, en imitant les fonctionnalités de la clé d’accueil.
public:
int HomeKey(TextRangeUnit unit, bool extend);int HomeKey(TextRangeUnit const& unit, bool const& extend);public int HomeKey(TextRangeUnit unit, bool extend);function homeKey(unit, extend)Public Function HomeKey (unit As TextRangeUnit, extend As Boolean) As IntegerParamètres
- unit
- TextRangeUnit
Unités par lesquelles déplacer le point d’insertion ou la fin active. Les valeurs suivantes sont valides.
- extend
-
Boolean
bool
Indique comment modifier la sélection. True étend la sélection en déplaçant uniquement l’extrémité active. False réduit la sélection en point d’insertion, puis déplace le point d’insertion. La valeur par défaut est false.
Retours
int
Nombre d’unités déplacées par le point d’insertion ou l’extrémité active.
Remarques
La méthode HomeKey est une méthode logique plutôt qu’une méthode directionnelle et dépend donc du langage impliqué. Par exemple, dans le texte arabe, HomeKey se déplace à l’extrémité droite d’une ligne, tandis que dans le texte anglais, elle se déplace vers la gauche. Ainsi, HomeKey est différent des méthodes ITextSelection.MoveRight ou ITextSelection.MoveLeft . HomeKey diffère également de la méthode ITextRange.StartOf en ce qu’elle s’étend à partir de l’extrémité active, tandis que StartOf s’étend à partir de la position de début.