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 der zu verschiebenden Texteinheiten. Ein positiver Wert verschiebt den Textbereich vorwärts. Ein negativer Wert verschiebt den Textbereich rückwärts. 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 wurden. Dieser Wert kann negativ sein, wenn die Navigation in die Rückwärtsrichtung erfolgt.
Rückgabewert
Typ: HRESULT-
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
IUIAutomationTextRange::Move verschiebt den Textbereich auf einen anderen Teil des Texts; er ändert den Text nicht auf irgendeine Weise.
Für einen nicht entgenerten (nicht leeren) Textbereich IUIAutomationTextRange::Move normalisiert und verschiebt den Bereich durch Ausführen der folgenden Schritte.
- Der Textbereich wird auf einen entgenerierten (leeren) Bereich am Startendpunkt reduziert.
- Bei Bedarf wird der resultierende Textbereich im Dokument an den Anfang der angeforderten Texteinheitsgrenze zurück verschoben.
- Der Textbereich wird um die angeforderte Anzahl von Texteinheitsgrenzen im Dokument vorwärts oder rückwärts verschoben.
- Der Textbereich wird aus dem degeneraten Zustand erweitert, indem der endpunktende Endpunkt um eine angeforderte Texteinheitsgrenze vorwärts verschoben wird.
Bei einem entgenerten 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 berücksichtigt ausgeblendeten und sichtbaren Text.
Wenn ein textbasiertes Steuerelement die durch die Einheit Parameter angegebene Texteinheit nicht unterstützt, ersetzt IUIAutomationTextRange::Move die nächste größere unterstützte Texteinheit.
Die Größe der Texteinheiten, von der kleinsten einheit zum größten, lautet wie folgt.
- Zeichen
- Format
- Wort
- Linie
- Paragraph
- 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 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ächenautomatisierungs-Texteinheiten oder Unterstützung für die Benutzeroberflächenautomatisierung für Textinhalte.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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] |
| mindestens unterstützte 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- | Fenster |
| Header- | uiautomationclient.h (include UIAutomation.h) |
Siehe auch
Benutzeroberflächenautomatisierungsunterstützung für Textinhalte