ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metoda

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

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()

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