Språk

ITextRangeProvider.MoveEndpointByUnit Metod

Definition

Flyttar en slutpunkt i textområdet det angivna antalet textenheter inom dokumentintervallet.

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

Parametrar

endpoint
TextPatternRangeEndpoint

Slutpunkten som ska flyttas.

unit
TextUnit

Textenheten för att flytta.

count
Int32

Antalet enheter som ska flyttas. Ett positivt värde flyttar slutpunkten framåt. Ett negativt värde flyttas bakåt. Värdet 0 har ingen effekt.

Returer

Antalet enheter som faktiskt har flyttats, vilket kan vara mindre än det begärda antalet om en flytt av slutpunkten går till början eller slutet av dokumentet.

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

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

Gäller för