Język

ITextRangeProvider.Move(TextUnit, Int32) Metoda

Definicja

Przestrzeń nazw:
System.Windows.Automation.Provider
Zestaw:
UIAutomationProvider.dll
Zestawy:
UIAutomationProvider.dll, UIAutomationTypes.dll
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 tekstu.

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 żadnego wpływu.

Zwraca

Int32

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

Uwagi

Kiedy konieczne jest przetwarzanie zawartości zakresu tekstu, za kulisami zachodzi szereg kroków, aby metoda Move została pomyślnie wykonana.

  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 niepotrzebny. Ten krok jest niezbędny do usunięcia niejednoznaczności w sytuacjach, w których zakres tekstu obejmuje unit granice, na przykład "{Lista RL https://www.microsoft.com/ U}jest osadzona w tekście", gdzie "{" i "}" są punktami końcowymi zakresu tekstu.

  2. Zakres wynikowy jest cofany w DocumentRange do początku żądanej granicy unit.

  3. Zakres jest przesuwany 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ę.

Korekty zakresu według korekt Move &ExpandToEnclosingUnit 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 widoczna jako pojedynczy, ciągły strumień tekstowy zarówno w widoku kontrolki, jak i w widoku zawartości drzewa automatyzacji interfejsu użytkownika; granice obiektów są ignorowane.

Zakresy tekstu mieszczące się w obiektach osadzonych. Przykład strumienia tekstowego z osadzonymi obiektami i ich zakresami

Move uwzględnia zarówno ukryty, jak i widoczny tekst.

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

Kolejność, od najmniejszej jednostki do największej, jest wymieniona poniżej.

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

Dotyczy