Freigeben über

ITextRangeProvider::MoveEndpointByUnit-Methode (uiautomationcore.h)

  • Artikel

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

Syntax

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

Parameter

[in] endpoint

Typ: TextPatternRangeEndpoint-

Der zu verschiebende Endpunkt.

[in] unit

Typ: TextUnit-

Der Typ der Texteinheiten, z. B. Zeichen, Wort, Absatz usw.

[in] count

Typ: int

Die Anzahl der zu verschiebenden Einheiten. Ein positiver Wert verschiebt den Endpunkt vorwärts. Ein negativer Wert bewegt sich rückwärts. Ein Wert von 0 hat keine Auswirkung.

[out, retval] pRetVal

Typ: int*

Empfängt die Anzahl der tatsächlich verschobenen Einheiten, die kleiner als die angeforderte Zahl sein kann, wenn das Verschieben des Endpunkts am Anfang oder Ende des Dokuments erfolgt.

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

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

Abbildung der Endpunkte eines Textbereichs, der verschoben wird, wenn der Endpunkt verschoben wird, den anderen Endpunkt desselben Textbereichs überschreitet, wird auch der andere Endpunkt verschoben, was zu einem degenerierte Bereich führt und die richtige Reihenfolge des Endpunkts (d. d. a., dass der Start immer kleiner oder gleich dem Ende ist).

ITextRangeProvider::MoveEndpointByUnit wird 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 zum größten, wird hier aufgeführt.

  • Zeichen-
  • Format-
  • Word-
  • Zeilen-
  • Absatz
  • Seite
  • Dokument-

Bereichsverhalten, wenn EinheitTextUnit::Format

TextUnit::Format als Einheit positioniert Wert 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 Grenzen eines eingebetteten Objekts verschieben oder erweitern, z. B. ein Bild oder einen Hyperlink. Weitere Informationen finden Sie unter Benutzeroberflächenautomatisierungs-Texteinheiten oder Text- und TextRange-Steuerelementmuster.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform- Fenster
Header- uiautomationcore.h (include UIAutomation.h)

Siehe auch

Konzeptionelle

ITextProvider-

ITextRangeProvider-

Referenz-

Text- und TextRange-Steuerelementmuster

Übersicht über Benutzeroberflächenautomatisierungs-Anbieter