Språk

ITextRangeProvider.Move(TextUnit, Int32) Metod

Definition

Namnområde:
System.Windows.Automation.Provider
Sammansättning:
UIAutomationProvider.dll
Sammansättningar:
UIAutomationProvider.dll, UIAutomationTypes.dll
Sammansättning:
UIAutomationTypes.dll

Flyttar textområdet det angivna antalet textenheter.

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

Parametrar

unit
TextUnit

Textenhetens gräns.

count
Int32

Antalet textenheter som ska flyttas.

Ett positivt värde flyttar textområdet framåt, ett negativt värde flyttar textområdet bakåt och 0 har ingen effekt.

Returer

Int32

Antalet enheter som faktiskt har flyttats. Detta kan vara mindre än det begärda antalet om någon av de nya textintervallslutpunkterna är större än eller mindre än DocumentRange slutpunkterna.

Kommentarer

När det är nödvändigt att bläddra igenom innehållet i ett textintervall är en serie steg inblandade i bakgrunden för att metoden Move ska kunna köras korrekt.

  1. Textområdet normaliseras. Det innebär att textintervallet minimeras till ett degenererat intervall vid Start slutpunkten, vilket gör End slutpunkten överflödig. Det här steget är nödvändigt för att ta bort tvetydighet i situationer där ett textintervall sträcker sig över unit gränser, till exempel "{U}RL https://www.microsoft.com/ är inbäddad i text" där "{" och "}" är slutpunkterna för textintervallet.

  2. Det resulterande intervallet flyttas bakåt genom DocumentRange till början av den begärda unit gränsen.

  3. Intervallet flyttas framåt eller bakåt i DocumentRange med det begärda antalet unit gränser.

  4. Intervallet expanderas sedan från ett degenererat intervalltillstånd genom att slutpunkten End flyttas med en begärd unit gräns.

Intervalljusteringar efter Flytta och ExpanderaToEnclosingUnit-intervalljusteringar Exempel på hur ett textintervall justeras för Move() och ExpandToEnclosingUnit()

Textinnehållet (eller den inre texten) i en textcontainer och ett inbäddat objekt, till exempel en hyperlänk eller tabellcell, exponeras som en enda kontinuerlig textström i både kontrollvyn och innehållsvyn i UI Automation-trädet. objektgränser ignoreras.

Textintervall som sträcker sig över inbäddade objekt. Exempel på en textström med inbäddade objekt och deras intervallintervall

Move respekterar både dold och synlig text.

Move defers till den näst största TextUnit som stöds om den angivna TextUnit inte stöds av kontrollen.

Ordningen, från den minsta enheten till den största, visas nedan.

Texten ändras inte på något sätt, textområdet sträcker sig bara över en annan del av texten.

Gäller för