ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metoda

Definice

Obor názvů:

System.Windows.Automation.Provider

Sestavení:

UIAutomationTypes.dll

Rozbalí oblast textu na zadanou textovou jednotku.

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);

public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);

abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit

Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Parametry

unit

TextUnit

Textová jednotka.

Poznámky

Pokud je rozsah již přesným množstvím zadaných jednotek, zůstane beze změny.

Na pozadí se provádí ř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()

Poznámka

Tyto kroky jsou nezbytné, protože čtečka obrazovky obvykle přečte celé slovo, větu nebo celý odstavec v místě vložení nebo v libovolné pozici virtuálního kurzoru.

ExpandToEnclosingUnit respektuje skrytý i viditelný text.

ExpandToEnclosingUnitpokud 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