Taal

ITextRangeProvider.Move(TextUnit, Int32) Methode

Definitie

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

Hiermee verplaatst u het tekstbereik het opgegeven aantal teksteenheden.

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

Parameters

unit
TextUnit

De grens van de teksteenheid.

count
Int32

Het aantal te verplaatsen teksteenheden.

Een positieve waarde verplaatst het tekstbereik vooruit, een negatieve waarde verplaatst het tekstbereik naar achteren en 0 heeft geen effect.

Retouren

Int32

Het aantal eenheden dat daadwerkelijk is verplaatst. Dit kan kleiner zijn dan het aangevraagde aantal als een van de nieuwe eindpunten van het tekstbereik groter is dan of kleiner is dan de DocumentRange eindpunten.

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 naar voren of naar achteren verplaatst in DocumentRange met het aangevraagde aantal unit grenzen.

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

De tekstuele inhoud (of binnenste tekst) van een tekstcontainer en een ingesloten object, zoals een hyperlink of tabelcel, wordt weergegeven als één doorlopende tekststroom in zowel de besturingsweergave als de inhoudsweergave van de UI Automation-structuur; objectgrenzen worden genegeerd.

Tekstbereiken die zijn verspreid door ingesloten objecten. Voorbeeld van een tekststroom met ingesloten objecten en de bijbehorende bereikbereiken

Move respecteert zowel verborgen als zichtbare tekst.

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

De tekst wordt op geen enkele manier gewijzigd, het tekstbereik beslaat slechts een ander deel van de tekst.

Van toepassing op