ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Provider

Zestaw:

UIAutomationTypes.dll

Rozwija zakres tekstu do określonej jednostki tekstowej.

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

Jednostka tekstowa.

Uwagi

Jeśli zakres jest już dokładną ilością określonych jednostek, pozostaje niezmieniony.

Istnieje szereg kroków, które należy wykonać w tle, aby Move metoda została wykonana pomyślnie.

1. Zakres tekstu jest znormalizowany; oznacza to, że zakres tekstu jest zwinięty do zdegenerowanego zakresu w Start punkcie końcowym, co sprawia, że End punkt końcowy jest zbędny. Ten krok jest niezbędny do usunięcia niejednoznaczności w sytuacjach, w których zakres tekstu obejmuje unit granice, na przykład "{U}RL https://www.microsoft.com/ jest osadzony w tekście", gdzie "{" i "}" są punktami końcowymi zakresu tekstu.

2. Wynikowy zakres jest przenoszony do DocumentRange tyłu na początku żądanej unit granicy.

3. Zakres jest przenoszony do przodu lub do tyłu DocumentRange przez żądaną liczbę unit granic.

4. Zakres jest następnie rozszerzany z zdegenerowanego stanu zakresu przez przeniesienie End punktu końcowego przez jedną żądaną unit granicę.

Przykłady dostosowania zakresu tekstu dla funkcji Move() i ExpandToEnclosingUnit()

Uwaga

Te kroki są niezbędne, ponieważ czytnik zawartości ekranu jest często odczytywany pełny wyraz, zdanie lub cały akapit w punkcie wstawiania lub w dowolnym wirtualnym położeniu kursora.

ExpandToEnclosingUnit szanuje zarówno ukryty, jak i widoczny tekst.

ExpandToEnclosingUnit defers do następnego największego TextUnit obsługiwanego, jeśli dana wartość TextUnit nie jest obsługiwana przez kontrolkę.

Kolejność, od najmniejszej jednostki do największej, znajduje się poniżej.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document