ITextRangeProvider.Move(TextUnit, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Provider

Zestaw:

UIAutomationTypes.dll

Przenosi zakres tekstu o określonej liczbie jednostek tekstowych.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);

public int Move (System.Windows.Automation.Text.TextUnit unit, int count);

abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int

Public Function Move (unit As TextUnit, count As Integer) As Integer

Parametry

unit

TextUnit

Granica jednostki tekstowej.

count

Int32

Liczba jednostek tekstowych do przeniesienia.

Wartość dodatnia przenosi zakres tekstu do przodu, wartość ujemna przenosi zakres tekstu do tyłu, a wartość 0 nie ma wpływu.

Zwraca

Int32

Liczba jednostek rzeczywiście została przeniesiona. Może to być mniejsze niż liczba żądana, jeśli jeden z nowych punktów końcowych zakresu tekstu jest większy lub mniejszy niż DocumentRange punkty końcowe.

Uwagi

Gdy konieczne jest przejście przez zawartość zakresu tekstu, seria kroków jest zaangażowana 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()

Zawartość tekstowa (lub tekst wewnętrzny) kontenera tekstowego i osadzonego obiektu, takiego jak hiperlink lub komórka tabeli, jest uwidoczniona jako pojedynczy, ciągły strumień tekstowy zarówno w widoku kontrolki, jak i widoku zawartości drzewa automatyzacja interfejsu użytkownika; granice obiektów są ignorowane.

Przykład strumienia tekstu z osadzonymi obiektami i zakresami ich zakresów

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

Move 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

Tekst nie jest zmieniany w żaden sposób, zakres tekstu obejmuje tylko inną część tekstu.