ITextRangeProvider.MoveEndpointByUnit Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assemblys:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

Déplace un point de terminaison de la plage de texte du nombre spécifié d'unités de texte dans la plage de documents.

public:
 int MoveEndpointByUnit(System::Windows::Automation::Text::TextPatternRangeEndpoint endpoint, System::Windows::Automation::Text::TextUnit unit, int count);
public int MoveEndpointByUnit (System.Windows.Automation.Text.TextPatternRangeEndpoint endpoint, System.Windows.Automation.Text.TextUnit unit, int count);
abstract member MoveEndpointByUnit : System.Windows.Automation.Text.TextPatternRangeEndpoint * System.Windows.Automation.Text.TextUnit * int -> int
Public Function MoveEndpointByUnit (endpoint As TextPatternRangeEndpoint, unit As TextUnit, count As Integer) As Integer

Paramètres

endpoint
TextPatternRangeEndpoint

Point de terminaison à déplacer.

unit
TextUnit

Unité de texte à déplacer.

count
Int32

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

Retours

Int32

Nombre d'unités réellement déplacées, qui peut être inférieur au nombre requis si le déplacement des points de terminaison atteint le début ou la fin du document.

Remarques

Quand il est nécessaire de parcourir le contenu d'une plage de texte, il faut effectuer une série d'étapes en arrière-plan pour assurer la bonne exécution de la méthode Move .

  1. La plage de texte est normalisée : elle est réduite en une plage dégénérée au niveau du point de terminaison Start , rendant le point de terminaison End superflu. Cette étape est nécessaire pour supprimer l’ambiguïté dans les situations où une plage de texte dépasse les unit limites ; par exemple, « {L’U}RL https://www.microsoft.com/ est incorporée dans le texte » où « { » et « } » sont les points de terminaison de la plage de texte.

  2. La plage obtenue est déplacée vers l'arrière dans DocumentRange au début de la limite unit demandée.

  3. La plage est ensuite étendue à partir d'un état de plage dégénérée en déplaçant le point de terminaison End d'une limite unit demandée.

Ajustements de plage par Move & ExpandToEnclosingUnit
Exemples de la façon dont une plage de texte est ajustée pour Move() et ExpandToEnclosingUnit()

MoveEndpointByUnit passe au plus grand TextUnit suivant pris en charge si le donné TextUnit n’est pas pris en charge par le contrôle.

L’ordre, de la plus petite à la plus grande, est répertorié ci-dessous.

S’applique à