Langue

ITextRangeProvider.Move(TextUnit, Int32) Méthode

Définition

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

Déplace la plage de texte le nombre spécifié d’unités de texte.

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

Paramètres

unit
TextUnit

Limite de l’unité de texte.

count
Int32

Nombre d’unités de texte à déplacer.

Une valeur positive déplace la plage de texte vers l’avant, une valeur négative déplace la plage de texte vers l’arrière et 0 n’a aucun effet.

Retours

Int32

Nombre d’unités réellement déplacées. Cela peut être inférieur au nombre demandé si l’un des nouveaux points de terminaison de plage de texte est supérieur ou inférieur aux DocumentRange points de terminaison.

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 avancée ou reculée dans DocumentRange du nombre demandé de limites unit .

  4. 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()

Le contenu textuel (ou texte interne) d’un conteneur de texte et d’un objet incorporé, tel qu’un lien hypertexte ou une cellule de tableau, est exposé sous la forme d’un flux de texte unique et continu dans la vue de contrôle et l’affichage de contenu de l’arborescence UI Automation ; les limites d’objet sont ignorées.

Plages de texte étendues par des objets incorporés. Exemple de flux de texte avec des objets incorporés et leurs étendues de plage

Move respecte le texte masqué et visible.

Move 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.

Le texte n’est pas modifié d’une manière quelconque, la plage de texte s’étend simplement sur une autre partie du texte.

S’applique à