ITextRangeProvider.MoveEndpointByUnit Methode

Definition

Namespace:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assemblys:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

Verschiebt einen Endpunkt des Textbereichs um die angegebene Anzahl von Texteinheiten innerhalb des Dokumentbereichs.

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

Parameter

endpoint
TextPatternRangeEndpoint

Der zu verschiebende Endpunkt.

unit
TextUnit

Die Texteinheit zum Verschieben.

count
Int32

Die Anzahl der Einheiten, um die verschoben werden soll. Ein positiver Wert verschiebt den Endpunkt vorwärts. Ein negativer Wert bewegt sich rückwärts. Ein Wert von 0 hat keine Auswirkung.

Gibt zurück

Int32

Die Anzahl der tatsächlich verschobenen Einheiten, die kleiner als die angeforderte Zahl sein kann, wenn das Verschieben des Endpunkts am Anfang oder Ende des Dokuments erfolgt.

Hinweise

Wenn es erforderlich ist, den Inhalt eines Textbereichs zu durchlaufen, sind hinter den Kulissen eine Reihe von Schritten beteiligt, damit die Move Methode erfolgreich ausgeführt werden kann.

  1. Der Textbereich wird normalisiert; d. h. der Textbereich wird auf einen degenerierten Bereich am Start Endpunkt reduziert, wodurch der End Endpunkt überflüssig wird. Dieser Schritt ist erforderlich, um Mehrdeutigkeit in Situationen zu entfernen, in denen ein Textbereich Grenzen umfasst unit , z. B. "{Die U}RL https://www.microsoft.com/ ist in Text eingebettet", wobei "{" und "}" die Endpunkte des Textbereichs sind.

  2. Der resultierende Bereich wird im DocumentRange zurück an den Anfang der angeforderten unit -Grenze verschoben.

  3. Der Bereich wird dann von einem degenerierten Bereichszustand erweitert, indem der End Endpunkt um eine angeforderte unit Grenze verschoben wird.

Bereichsanpassungen durch Move & ExpandToEnclosingUnit Beispiele für die Anpassung eines Textbereichs für Move() und ExpandToEnclosingUnit()

MoveEndpointByUnit Wird auf die nächstgrößte TextUnit unterstützung zurückverzögert, wenn das angegebene TextUnit Steuerelement nicht unterstützt wird.

Die Reihenfolge, von der kleinsten Einheit bis zum größten, wird unten aufgeführt.

Gilt für: