ITextRange::MoveEnd-Methode (tom.h)

Verschiebt die Endposition des Bereichs.

Syntax

HRESULT MoveEnd(
  long Unit,
  long Count,
  long *pDelta
);

Parameter

Unit

Typ: long

Die Einheiten, um die das Ende des Bereichs verschoben werden soll. Der Standardwert ist tomCharacter. Eine Liste der anderen Einheitenwerte finden Sie unter ITextRange.

Count

Typ: long

Die Anzahl der Einheiten, die in die Vergangenheit verschoben werden sollen. Der Standardwert ist 1. Wenn Count größer als 0 ist, erfolgt die Bewegung vorwärts – gegen Ende der Geschichte – und wenn Count kleiner als 0 ist, ist die Bewegung rückwärts – zum Anfang hin. Wenn Count 0 ist, bleibt die Endposition unverändert.

pDelta

Typ: long*

Die tatsächliche Anzahl von Einheiten, an die die Endposition des Bereichs verschoben wird. Der Wert 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_NOTIMPL	Unit wird nicht unterstützt.
S_FALSE	Fehler aus einem anderen Grund.

Hinweise

Wenn die neue Endposition der alten Startposition vorangeht, wird die neue Startposition gleich der neuen Endposition festgelegt. Das heißt, es wird ein degenerierter Bereich oder eine Einfügemarke.

Die von ITextRange::MoveEnd beschriebene Bewegung ist logisch und nicht geometrisch. Das heißt, Bewegung geht zum Ende oder zum Anfang einer Geschichte. Je nach Sprache kann der Wechsel zum Ende der Geschichte nach links oder rechts erfolgen.

Weitere Informationen finden Sie unter ITextRange und ITextRange::Move.

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

ITextRange

Verschieben

Referenz

Textobjektmodell