Taal

ITextRangeProvider.MoveEndpointByUnit Methode

Definitie

Naamruimte:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assembly's:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

Hiermee verplaatst u één eindpunt van het tekstbereik het opgegeven aantal teksteenheden binnen het documentbereik.

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

Parameters

endpoint
TextPatternRangeEndpoint

Het eindpunt dat moet worden verplaatst.

unit
TextUnit

De tekstuele eenheid voor het verplaatsen.

count
Int32

Het aantal eenheden dat moet worden verplaatst. Een positieve waarde verplaatst het eindpunt naar voren. Een negatieve waarde gaat achteruit. Een waarde van 0 heeft geen effect.

Retouren

Int32

Het aantal eenheden dat daadwerkelijk is verplaatst, wat kleiner kan zijn dan het aangevraagde aantal als het eindpunt wordt verplaatst naar het begin of einde van het document.

Opmerkingen

Wanneer het nodig is om de inhoud van een tekstbereik te doorlopen, wordt achter de schermen een reeks stappen uitgevoerd om de Move methode succesvol uit te voeren.

  1. Het tekstbereik wordt genormaliseerd; Dat wil gezegd: het tekstbereik wordt samengevouwen tot een degenererend bereik op het Start eindpunt, waardoor het End eindpunt overbodig wordt. Deze stap is nodig om dubbelzinnigheid te verwijderen in situaties waarin een tekstbereik grenzen omvat unit , bijvoorbeeld {De U}RL https://www.microsoft.com/ is ingesloten in tekst, waarbij {en }de eindpunten van het tekstbereik zijn.

  2. Het resulterende bereik wordt verplaatst achterwaarts in de DocumentRange tot het begin van de aangevraagde unit grens.

  3. Het bereik wordt vervolgens uitgebreid vanuit een gedegenereerde toestand door het End eindpunt met één aangevraagde unit grens te verplaatsen.

Bereikaanpassingen door Move & ExpandToEnclosingUnit Voorbeelden van hoe een tekstbereik wordt aangepast voor Move() en ExpandToEnclosingUnit()

MoveEndpointByUnit wordt uitgesteld tot het eerstvolgende grootste TextUnit ondersteund als de opgegeven TextUnit niet wordt ondersteund door het besturingselement.

De volgorde, van kleinste eenheid tot grootste, wordt hieronder vermeld.

Van toepassing op