ITextRangeProvider.MoveEndpointByUnit Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Provider

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

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

MoveEndpointByUnit 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