Język

ITextRangeProvider.MoveEndpointByUnit Metoda

Definicja

Przestrzeń nazw:
System.Windows.Automation.Provider
Zestaw:
UIAutomationProvider.dll
Zestawy:
UIAutomationProvider.dll, UIAutomationTypes.dll
Zestaw:
UIAutomationTypes.dll

Przenosi jeden punkt końcowy zakresu tekstu o określonej liczbie jednostek tekstowych w zakresie dokumentów.

public:
 int MoveEndpointByUnit(System::Windows::Automation::Text::TextPatternRangeEndpoint endpoint, System::Windows::Automation::Text::TextUnit unit, int count);
public int MoveEndpointByUnit(System.Windows.Automation.Text.TextPatternRangeEndpoint endpoint, System.Windows.Automation.Text.TextUnit unit, int count);
abstract member MoveEndpointByUnit : System.Windows.Automation.Text.TextPatternRangeEndpoint * System.Windows.Automation.Text.TextUnit * int -> int
Public Function MoveEndpointByUnit (endpoint As TextPatternRangeEndpoint, unit As TextUnit, count As Integer) As Integer

Parametry

endpoint
TextPatternRangeEndpoint

Punkt końcowy do przeniesienia.

unit
TextUnit

Jednostka tekstowa do przenoszenia.

count
Int32

Liczba jednostek do przeniesienia. Wartość dodatnia przenosi punkt końcowy do przodu. Wartość ujemna przesuwa się do tyłu. Wartość 0 nie ma wpływu.

Zwraca

Int32

Liczba jednostek rzeczywiście przeniesionych, która może być mniejsza niż liczba żądana, jeśli przeniesienie punktu końcowego zostanie uruchomione na początku lub na końcu dokumentu.

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

MoveEndpointByUnit 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.

Dotyczy