ITextRangeProvider.Move(TextUnit, Int32) Metoda

Definice

Obor názvů:

System.Windows.Automation.Provider

Sestavení:

UIAutomationTypes.dll

Přesune rozsah textu na zadaný počet textových jednotek.

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

Parametry

unit

TextUnit

Hranice textové jednotky.

count

Int32

Počet textových jednotek, které se mají přesunout.

Kladná hodnota přesune oblast textu dopředu, záporná hodnota posune oblast textu dozadu a hodnota 0 nemá žádný vliv.

Návraty

Int32

Počet skutečně přesunutých jednotek To může být menší než požadované číslo, pokud je některý z nových koncových bodů textového rozsahu DocumentRange větší než nebo menší než koncové body.

Poznámky

Pokud je nutné procházet obsah textového rozsahu, je na pozadí zapojena řada kroků, Move aby se metoda úspěšně spustila.

1. Rozsah textu je normalizován; to znamená, že oblast textu je na koncovém bodu sbalená do degenerovaného rozsahu StartEnd , takže koncový bod je nadbytečný. Tento krok je nezbytný k odstranění nejednoznačnosti v situacích, kdy rozsah textu přesahuje unit hranice, například {seznam U}RL https://www.microsoft.com/ je vložený do textu, kde {a } jsou koncové body oblasti textu.

2. Výsledný rozsah se přesune dozadu DocumentRange na začátek požadovaného ohraničení unit .

3. Rozsah je posunut dopředu nebo dozadu v DocumentRange požadovaném počtu unit hranic.

4. Oblast se pak rozbalí ze stavu degenerovaného rozsahu přesunutím koncového End bodu o jednu požadovanou unit hranici.

Příklady úprav rozsahu textu pro Move() a ExpandToEnclosingUnit()

Textový obsah (nebo vnitřní text) textového kontejneru a vloženého objektu, jako je hypertextový odkaz nebo buňka tabulky, je vystaven jako jeden souvislý textový proud v zobrazení ovládacího prvku i v zobrazení obsahu stromu model UI Automation; hranice objektů jsou ignorovány.

Příklad textového streamu s vloženými objekty a jejich rozsahy

Move respektuje skrytý i viditelný text.

Movepokud daný TextUnit ovládací prvek nepodporuje, na další největší TextUnit podporovanou hodnotu.

Pořadí od nejmenších jednotek po největší je uvedené níže.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

Text se žádným způsobem nezmění, rozsah textu pouze překlenuje jinou část textu.