ITextSelection::MoveRight-Methode (tom.h)

Artikel
08/26/2023

Generalisiert die Funktionalität der NACH-RECHTS-TASTE.

Syntax

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Parameter

Unit

Typ: long

Zu verwendende Einheit. Dies kann einer der folgenden Sein:

Wert	Entsprechende Tastenkombination	Bedeutung
tomCharacter	NACH-RECHTS	Verschieben Sie eine Zeichenposition nach rechts. Dies ist die Standardoption.
tomWord	STRG+NACH-RECHTS	Verschieben Sie ein Wort nach rechts.

Beachten Sie, dass die Bewegung nach links erfolgt, wenn Count kleiner als 0 (null) ist.

Count

Typ: long

Anzahl der Zu verschiebenden Einheiten. Der Standardwert ist 1. Wenn Count kleiner als 0 (Null) ist, erfolgt die Bewegung nach links.

Extend

Typ: long

Flag, das angibt, wie die Auswahl geändert werden soll. Wenn Extend null (oder tomMove) ist, reduziert die -Methode die Auswahl auf eine Einfügemarke am aktiven Ende und verschiebt sie dann. Wenn Extend den Wert 1 (oder tomExtend) hat, verschiebt die Methode das aktive Ende und lässt das andere Ende allein. Der Standardwert ist 0 (null). Ein Extend-Wert ungleich 0o entspricht der UMSCHALTTASTE, die zusätzlich zur unter Einheit beschriebenen Tastenkombination gedrückt wird.

pDelta

Typ: long*

Die tatsächliche Anzahl der Einheiten, die die Einfügemarke oder das aktive Ende nach links verschoben wird. Dieser Parameter kann NULL sein. Das Reduzieren der Auswahl, wenn Erweitern auf 0 festgelegt ist, zählt als eine Einheit.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
E_INVALIDARG	Die Einheit ist ungültig.
S_FALSE	Fehler aus einem anderen Grund.

Hinweise

Microsoft WordBasic-Verschiebungsmethoden wie CharRight, CharLeft, WordRight und WordLeft sind Hybriden, die vier Dinge ausführen können, die eng mit dem standardmäßigen Bearbeitungsverhalten für Pfeiltasten verbunden sind:

Verschieben Sie die aktuelle Einfügemarke, wenn keine Auswahl vorhanden ist.
Verschieben Sie das aktive Ende der Auswahl, wenn eine Auswahl vorhanden ist.
Wandeln Sie eine Einfügemarke in eine Auswahl um und umgekehrt.
Gibt einen booleschen Wert zurück, der angibt, ob eine Verschiebung aufgetreten ist.

Das Extend-Argument von MoveLeft und MoveRight ermöglicht es Ihnen, mit den ersten drei Elementen oben konsistent zu sein, und das pDelta ist eine Generalisierung des vierten. Wenn Sie z. B. eine Auswahl (s) auswählen, die aus einem einzelnen Bereich besteht, verfügen Sie über die folgenden Übereinstimmungen (für Zeichen von links nach rechts).

ITextSelection	Wordbasic	Funktion
s.MoveRight tomWord, 1, 1	WordRight 1,1	Verschiebt das aktive Ende um ein Wort nach rechts.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Verschiebt das aktive Ende um ein Zeichen nach links.

Wenn Count kleiner als 0 ist, werden wie in WordBasic die Bedeutungen von links und rechts ausgetauscht. Dies entspricht MoveLeft (Unit, Count, Extend)MoveRight(Unit, -Count, Extend).

Ähnlich wie wordBasic und das Verhalten der NACH-RECHTS-TASTE bei der Benutzeroberfläche verschiebt das Aufrufen MoveRight(Unit, Count) einer entarteten Auswahl die angegebene Anzahl von Einheiten an der Einfügemarke. In einem degeneraten Bereich führt das Aufrufen MoveRight(Unit, Count, 1) von where Count is größer als 0 (null) dazu, dass der Bereich nicht mehr entartet wird, wobei das rechte Ende das aktive Ende ist.

Wenn Extendauf tomExtend festgelegt ist (oder ungleich null ist), verschiebt MoveRight nur das aktive Ende der Auswahl und belässt das andere Ende dort, wo es sich befindet. Wenn Extend jedoch gleich 0 ist und die Auswahl als nicht entgenerierter Bereich beginnt, MoveRight(Unit, Count)Count verschiebt größer als 0 das aktive Ende Count – 1 Einheiten nach rechts, und verschiebt dann das andere Ende zum aktiven Ende. Mit anderen Worten, es wird eine Einfügemarke am aktiven Ende. Das Reduzieren des Bereichs zählt als eine Einheit. MoveRight(tomCharacter) Konvertiert daher eine nicht entartete Auswahl am rechten Ende der Auswahl in eine entartete Auswahl. Hier weist Count den Standardwert 1 und Extend den Standardwert 0 (null) auf. Dieses Beispiel entspricht dem Drücken der NACH-RECHTS-TASTE. MoveLeft und MoveRight beziehen sich auf die ITextRange-Verschiebungsmethoden , unterscheiden sich jedoch darin, dass sie explizit das aktive Ende verwenden (das Ende wird durch Drücken der UMSCHALTTASTE verschoben).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll