Freigeben über


ITextSelection::MoveUp-Methode (tom.h)

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

Siehe auch

Konzept

ITextSelection

Movedown

MoveLeft

MoveRight

Referenz

Textobjektmodell