ITextSelection::MoveLeft-Methode (tom.h)

Artikel
08/26/2023

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

Syntax

HRESULT MoveLeft(
  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-LINKS-TASTE	Verschieben Sie eine Zeichenposition nach links. Dies ist die Standardoption.
tomWord	STRG+NACH-LINKS	Verschieben Sie ein Wort nach links.

Hinweis: Wenn Count kleiner als 0 (Null) ist, erfolgt die Bewegung nach rechts.

Count

Typ: long

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

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

Die 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. Bei einer Auswahl, die aus einem einzelnen Bereich besteht, verfügen Sie beispielsweise über die folgenden Übereinstimmungen (für Zeichen von links nach rechts).

ITextSelection	Wordbasic	Funktion
Auswahl. MoveRight tomWord, 1, 1	WordRight 1,1	Verschiebt das aktive Ende um ein Wort nach rechts.
Auswahl. 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 bei WordBasic und dem Verhalten der NACH-LINKS-TASTE bei der Benutzeroberfläche verschiebt der Aufruf MoveLeft ( Unit, Count) bei einer entarteten Auswahl die angegebene Anzahl von Einheiten. In einem degeneraten Bereich führt das Aufrufen MoveLeft( Unit, Count, 1) von where where Count is größer als 0 (null) dazu, dass der Bereich nicht mehr entartet wird, wobei das linke Ende das aktive Ende ist.

Wenn Extendauf tomExtend festgelegt ist (oder ungleich null ist), verschiebt MoveLeft nur das aktive Ende der Auswahl, wobei das andere Ende an der Stelle bleibt, an der es sich befindet. Wenn Extend gleich 0 ist und die Auswahl als nicht entgenerierter Bereich beginnt, MoveLeft(Unit, Count)Count verschiebt größer als 0 das aktive Ende Count – 1 Einheiten nach links, 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. MoveLeft(tomCharacter) Konvertiert daher eine nicht entartete Auswahl am linken Ende der Auswahl in eine degenerate Auswahl. Hier weist Count den Standardwert 1 und Extend den Standardwert 0 (null) auf. Dieses Beispiel entspricht dem Drücken der NACH-LINKS-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


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