ITextRangeProvider.MoveEndpointByUnit Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.
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
unitgränser, till exempel "{U}RL https://www.microsoft.com/ är inbäddad i text" där "{" och "}" är slutpunkterna för textintervallet.Det resulterande intervallet flyttas bakåt genom DocumentRange till början av den begärda
unitgränsen.Intervallet expanderas sedan från ett degenererat intervalltillstånd genom att slutpunkten End flyttas med en begärd
unitgräns.
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.