ITextRangeProvider ::MoveEndpointByUnit, méthode (uiautomationcore.h)

Déplace un point de terminaison de la plage de texte le nombre spécifié d’unités TextUnit dans la plage de documents.

Syntaxe

HRESULT MoveEndpointByUnit(
  [in]          TextPatternRangeEndpoint endpoint,
  [in]          TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *pRetVal
);

Paramètres

[in] endpoint

Type : TextPatternRangeEndpoint

Point de terminaison à déplacer.

[in] unit

Type : TextUnit

Type d’unités de texte, telles que le caractère, le mot, le paragraphe, etc.

[in] count

Type : int

Nombre d’unités à déplacer. Une valeur positive déplace le point de terminaison vers l’avant. Une valeur négative se déplace vers l’arrière. La valeur 0 n’a aucun effet.

[out, retval] pRetVal

Type : int*

Reçoit le nombre d’unités réellement déplacées, ce qui peut être inférieur au nombre demandé si le déplacement du point de terminaison s’exécute dans le début ou la fin du document.

Valeur de retour

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.

Remarques

Le point de terminaison est déplacé vers l’avant ou vers l’arrière, comme spécifié, vers la limite d’unité disponible suivante. Si le point de terminaison d’origine était à la limite de l’unité de texte spécifiée, le point de terminaison est déplacé vers la limite d’unité de texte disponible suivante, comme illustré dans l’illustration suivante.