ITextRange::MoveStart-Methode (tom.h)
Verschiebt die Startposition des Bereichs um die angegebene Anzahl von Einheiten in die angegebene Richtung.
Syntax
HRESULT MoveStart(
long Unit,
long Count,
long *pDelta
);
Parameter
Unit
Typ: long
Einheit, die bei der Verschiebung verwendet wird. Der Standardwert ist tomCharacter. Eine Liste der anderen Einheitenwerte finden Sie in der Diskussion unter ITextRange.
Count
Typ: long
Anzahl der zu verschiebenden Einheiten. 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 Startposition unverändert.
pDelta
Typ: long*
Die tatsächliche Anzahl der Einheiten, die das Ende 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 |
---|---|
|
Unit wird nicht unterstützt. |
|
Fehler aus einem anderen Grund. |
Hinweise
Wenn der neue Start dem alten Ende folgt, wird das neue Ende gleich dem neuen Start festgelegt.
Die von ITextRange::MoveStart 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
Referenz