ITextSelection::MoveUp-Methode (tom.h)

Artikel
03/03/2024

Imitiert die Funktionalität der NACH-OBEN- und BILD-NACH-OBEN-TASTE.

Syntax

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

Parameter

Unit

Typ: long

Einheit, die im Vorgang verwendet werden soll. Dies kann einer der folgenden Sein:

Wert	Entsprechende Tastenkombination	Bedeutung
tomLine	NACH-OBEN	Wird um eine Zeile nach oben verschoben. Dies ist die Standardoption.
tomParagraph	STRG+NACH-OBEN	Verschiebt einen Absatz nach oben.
tomScreen	BILD-AUF	Wird um einen Bildschirm nach oben verschoben.
tomWindow	STRG+BILD-NACH-OBEN	Wechselt zum ersten Zeichen im Fenster.

Count

Typ: long

Anzahl der Zu verschiebenden Einheiten. Der Standardwert ist 1.

Extend

Typ: long

Flag, das angibt, wie die Auswahl geändert werden soll. Wenn Extend den Wert 0 (oder tomMove) aufweist, reduziert die Methode die Auswahl auf eine Einfügemarke und verschiebt sich 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 unten verschoben wird. Dieser Parameter kann NULL sein. Das Reduzieren der Auswahl 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 MoveUp - und MoveDown-Methoden ähneln den MoveLeft - und MoveRight-Methoden , mit der Ausnahme, dass sie das Verhalten der NACH-OBEN-, NACH-UNTEN-, BILD-NACH- und BILD-NACH-UNTEN-TASTE auf der Cursortaste widerspiegeln.

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