ITextRangeProvider.Move(TextUnit, Int32) Methode

Definition

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

Verschiebt den Textbereich in die angegebene Anzahl von Texteinheiten.

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

Parameter

unit
TextUnit

Die Texteinheitsgrenze.

count
Int32

Die Anzahl der zu verschiebenden Texteinheiten.

Ein positiver Wert verschiebt den Textbereich vorwärts, ein negativer Wert verschiebt den Textbereich rückwärts, und 0 hat keine Auswirkung.

Gibt zurück

Int32

Die Anzahl der tatsächlich verschobenen Einheiten. Dies kann kleiner als die angeforderte Zahl sein, wenn einer der neuen Textbereichsendpunkte größer oder kleiner als die DocumentRange Endpunkte ist.

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 um die angeforderte Anzahl von DocumentRange -Grenzen nach vorne oder nach hinten im unit verschoben.

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

Der textbezogene Inhalt (oder innerer Text) eines Textcontainers und eines eingebetteten Objekts, z. B. ein Link oder eine Tabellenzelle, wird als einzelner fortlaufender Textstrom sowohl in der Steuerelementansicht als auch in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur verfügbar gemacht; Objektgrenzen werden ignoriert.

Textbereiche, die sich über eingebettete Objekte erstrecken. Beispiel für einen Textstream mit eingebetteten Objekten und deren Bereichsspannen

Move berücksichtigt ausgeblendeten und sichtbaren Text.

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

Der Text wird in keiner Weise geändert, der Textbereich erstreckt sich nur über einen anderen Teil des Texts.

Gilt für: