ITextRangeProvider::MoveEndpointByUnit-Methode (uiautomationcore.h)

Verschiebt einen Endpunkt des Textbereichs um die angegebene Anzahl von TextUnit-Einheiten innerhalb des Dokumentbereichs.

Syntax

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

Parameter

endpoint

unit

[in] count

Typ: int

Die Anzahl der zu verschiebenden Einheiten. Bei einem positiven Wert wird der Endpunkt vorwärts verschoben. Bei einem negativen Wert wird der Endpunkt rückwärts verschoben. Der Wert 0 (null) hat keine Auswirkungen.

[out, retval] pRetVal

Typ: int*

Empfängt die Anzahl der tatsächlich verschobenen Einheiten, die kleiner sein kann als die angeforderte Zahl, wenn der Endpunkt an den Anfang oder das 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).

ITextRangeProvider::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 sollte jedoch keinen Textbereich über die Grenze eines eingebetteten Objekts verschieben oder erweitern, z. B. ein Bild oder link. Weitere Informationen finden Sie unter Benutzeroberflächenautomatisierung Texteinheiten oder Text- und TextRange-Steuerelementmuster.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)

Siehe auch

Konzept

ITextProvider

ITextRangeProvider

Referenz

Text- und TextRange-Steuerelementmuster

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter