Langue

ITextRangeProvider.MoveEndpointByUnit Méthode

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 le 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é textuelle pour le déplacement.

count
Int32

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.

Retours

Int32

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.

Remarques

Lorsqu’il est nécessaire de parcourir le contenu d’une plage de texte, une série d’étapes est impliquée en arrière-plan pour que la Move méthode s’exécute correctement.

  1. La plage de texte est normalisée ; autrement dit, la plage de texte est réduite à une plage dégénérée au niveau du Start point de terminaison, ce qui rend le End point de terminaison superflu. Cette étape est nécessaire pour supprimer l’ambiguïté dans les situations où une plage de texte s’étend sur des unit limites ; par exemple, « {La liste de révocation de certificats U} https://www.microsoft.com/ est incorporée dans le texte » où « { » et « } » sont les points de terminaison de plage de texte.

  2. La plage résultante est déplacée vers l’arrière dans le DocumentRange jusqu’au début de la limite demandée unit.

  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 l’ajustement d’une plage de texte pour Move() et ExpandToEnclosingUnit()

MoveEndpointByUnit reporte la plus grande TextUnit prise en charge suivante si l’élément donné TextUnit n’est pas pris en charge par le contrôle.

L’ordre, de la plus petite unité au plus grand, est répertorié ci-dessous.

S’applique à