Freigeben über


IUIAutomationTextRange::Move-Methode (uiautomationclient.h)

Verschiebt den Textbereich um die angegebene Anzahl von Texteinheiten vorwärts oder rückwärts.

Syntax

HRESULT Move(
  [in]          TextUnit unit,
  [in]          int      count,
  [out, retval] int      *moved
);

Parameter

[in] unit

Typ: TextUnit

Ein -Wert, der den Typ von Texteinheiten angibt, z. B. Zeichen, Wort, Absatz usw.

[in] count

Typ: int

Die Anzahl von Texteinheiten, um die der Textbereich verschoben werden soll. Ein positiver Wert verschiebt den Textbereich nach vorne. Ein negativer Wert verschiebt den Textbereich nach hinten. Null hat keine Auswirkung.

[out, retval] moved

Typ: int*

Empfängt die Anzahl der tatsächlich verschobenen Texteinheiten. Dies kann kleiner als die angeforderte Zahl sein, wenn einer der neuen Textbereichsendpunkte größer oder kleiner als die Endpunkte ist, die von der IUIAutomationTextPattern::D ocumentRange-Methode abgerufen werden. Dieser Wert kann negativ sein, wenn die Navigation in rückwärts gerichteter Richtung erfolgt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

IUIAutomationTextRange::Move verschiebt den Textbereich, um einen anderen Teil des Texts zu umfassen; der Text wird in keiner Weise geändert.

Für einen nicht entarteten (nicht leeren) Textbereich normalisiert IUIAutomationTextRange::Move den Bereich, indem die folgenden Schritte ausgeführt werden.

  1. Der Textbereich wird am Startendpunkt auf einen degenerierten (leeren) Bereich reduziert.
  2. Bei Bedarf wird der resultierende Textbereich im Dokument rückwärts an den Anfang der angeforderten Texteinheitsgrenze verschoben.
  3. Der Textbereich wird im Dokument um die angeforderte Anzahl von Texteinheitengrenzen vorwärts oder rückwärts verschoben.
  4. Der Textbereich wird aus dem entarteten Zustand erweitert, indem der Endendpunkt um eine angeforderte Texteinheitsgrenze nach vorne verschoben wird.
Wenn einer der vorherigen Schritte fehlschlägt, bleibt der Textbereich unverändert. Wenn der Textbereich nicht bis zur angeforderten Anzahl von Texteinheiten verschoben werden kann, sondern um eine kleinere Anzahl von Texteinheiten verschoben werden kann, wird der Textbereich um die kleinere Anzahl von Texteinheiten verschoben und auf die Anzahl der verschobenen Texteinheiten festgelegt.

Bei einem degeneraten Textbereich verschiebt IUIAutomationTextRange::Move einfach die Texteinfügemarke um die angegebene Anzahl von Texteinheiten.

Beim Verschieben eines Textbereichs ignoriert IUIAutomationTextRange::Move die Grenzen aller eingebetteten Objekte im Text.

IUIAutomationTextRange::Move respektiert sowohl ausgeblendeten als auch sichtbaren Text.

Wenn ein textbasiertes Steuerelement die durch den unit-Parameter angegebene Texteinheit nicht unterstützt, ersetzt IUIAutomationTextRange::Move die nächstgrößere unterstützte Texteinheit.

Die Größe der Texteinheiten, von der kleinsten Einheit bis zur größten, lautet wie folgt.

  • Zeichen
  • Format
  • Word
  • Linie
  • Paragraph
  • Page
  • Dokument

Bereichsverhalten bei EinheitTextUnit::Format

TextUnit::Format als Einheitswert positioniert die Grenze eines Textbereichs, um den Bereich basierend auf freigegebenen Textattributen (Format) des Texts innerhalb des Bereichs zu erweitern oder zu verschieben. Die Verwendung der Formattexteinheit verschiebt oder erweitert jedoch keinen Textbereich über die Grenze eines eingebetteten Objekts, z. B. eines Bilds oder Links. Weitere Informationen finden Sie unter Benutzeroberflächenautomatisierung Texteinheiten oder Benutzeroberflächenautomatisierung Unterstützung für Textinhalte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationTextRange

Benutzeroberflächenautomatisierung Unterstützung für Textinhalte