ITextRangeProvider.MoveEndpointByUnit Metoda

Definice

Obor názvů:

System.Windows.Automation.Provider

Sestavení:

UIAutomationTypes.dll

Přesune jeden koncový bod rozsahu textu o zadaný počet jednotek textu v rámci rozsahu dokumentu.

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

Parametry

endpoint

TextPatternRangeEndpoint

Koncový bod, který se má přesunout.

unit

TextUnit

Textová jednotka pro přesun.

count

Int32

Počet jednotek, které se mají přesunout. Kladná hodnota posune koncový bod vpřed. Záporná hodnota se přesune dozadu. Hodnota 0 nemá žádný vliv.

Návraty

Int32

Počet skutečně přesunutých jednotek, který může být menší než požadovaný počet, pokud přesun koncového bodu narazí na začátek nebo konec dokumentu.

Poznámky

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

1. Rozsah textu je normalizován; to znamená, že rozsah textu je v 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 "{Adresa U}RL https://www.microsoft.com/ je vložena do textu", kde {" a "}" jsou koncové body textového rozsahu.

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

3. Rozsah 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()

MoveEndpointByUnitpokud daný TextUnit ovládací prvek nepodporuje, přejde 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