ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.
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.Wynikowy zakres jest przenoszony do DocumentRange tyłu na początku żądanej
unit
granicy.Zakres jest przenoszony do przodu lub do tyłu DocumentRange przez żądaną liczbę
unit
granic.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.