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
Referenz
Text- und TextRange-Steuerelementmuster
Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für