IUIAutomationTextRange::MoveEndpointByUnit-Methode (uiautomationclient.h)

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

Syntax

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

Parameter

[in] endpoint

Typ: TextPatternRangeEndpoint

Ein Wert, der den zu verschiebenden Endpunkt (Start oder Ende) angibt.

[in] unit

Typ: TextUnit

Ein Wert, der die Texteinheit für das Verschieben angibt, z. B. Zeile oder Absatz.

[in] count

Typ: int

Die Anzahl der zu verschiebenden Einheiten. Eine positive Anzahl verschiebt den Endpunkt vorwärts. Eine negative Anzahl verschiebt diesen rückwärts. Der Anzahl 0 (null) hat keine Auswirkungen.

[out, retval] moved

Typ: int*

Empfängt die Anzahl der tatsächlich verschobenen Einheiten. Dieser Wert kann kleiner als die angeforderte Zahl sein, wenn der Endpunkt an den Anfang oder ende des Dokuments verschoben wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Endpunkt wird wie angegeben vorwärts oder rückwärts zur nächsten verfügbaren Einheitsgrenze verschoben. Wenn sich der ursprüngliche Endpunkt an der Grenze der angegebenen Texteinheit befand, wird der Endpunkt zur nächsten verfügbaren Texteinheitsgrenze verschoben, wie in der folgenden Abbildung dargestellt.

Wenn der zu verschiebende Endpunkt den anderen Endpunkt desselben Textbereichs kreuzt, wird auch der andere Endpunkt verschoben, was zu einem degeneraten Bereich führt und die richtige Reihenfolge des Endpunkts sicherstellt (d. a. dass der Start immer kleiner oder gleich dem Ende ist).

MoveEndpointByUnit ist bis zur nächsten unterstützten Texteinheit veraltet, wenn die angegebene Texteinheit vom Steuerelement nicht unterstützt wird.

Die Reihenfolge, von der kleinsten Einheit bis zur größten, ist hier aufgeführt.

• Zeichen
• Format
• Word
• Linie
• Paragraph
• Seite
• Document

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 Grenzen eines eingebetteten Objekts, z. B. ein Bild oder einen Link. 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