ITextSelection::MoveDown-Methode (tom.h)

Artikel
03/03/2024

Ahmt die Funktionalität der NACH-UNTEN- und DER NACH-UNTEN-TASTE nach.

Syntax

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

Parameter

Unit

Typ: long

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

Wert	Entsprechende Tastenkombination	Bedeutung
tomLine	NACH-UNTEN	Bewegt sich eine Zeile nach unten. Dies ist die Standardoption.
tomParagraph	STRG+NACH-UNTEN	Verschiebt einen Absatz nach unten.
tomScreen	BILD-AB	Verschiebt einen Bildschirm nach unten.
tomWindow	STRG+SEITE NACH UNTEN	Wechselt zum letzten Zeichen im Fenster.

Count

Typ: long

Anzahl der Einheiten, die in die Vergangenheit verschoben werden sollen. Der Standardwert ist 1.

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 und verschiebt sich dann. Wenn Extend 1 (oder tomExtend) ist, verschiebt die Methode das aktive Ende und lässt das andere Ende in Ruhe. Der Standardwert ist 0 (null). Ein nonzero Extend-Wert entspricht der UMSCHALTTASTE, die zusätzlich zur in Einheit beschriebenen Tastenkombination gedrückt wird.

pDelta

Typ: long*

Zeiger auf eine Variable, die die tatsächliche Anzahl der Einheiten empfängt, die die Einfügemarke oder das aktive Ende nach unten verschoben wird. Das Reduzieren der Auswahl zählt zu einer Einheit. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. 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 Methoden ITextSelection::MoveUp und ITextSelection::MoveDown ähneln den Methoden ITextSelection::MoveLeft und ITextSelection::MoveRight , mit der Ausnahme, dass sie das Verhalten der Nach-oben-, Nach-unten-, Seiten-nach-oben- und Page-Down-Tasten 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