ITextRange::EndOf-Methode (tom.h)
Verschiebt die Enden dieses Bereichs an das Ende der letzten sich überlappenden Einheit im Bereich.
Syntax
HRESULT EndOf(
long Unit,
long Extend,
long *pDelta
);
Parameter
Unit
Typ: long
Zu verwendende Einheit. Standardwert: tomWord. Eine Liste der anderen Einheitenwerte finden Sie in der Diskussion unter ITextRange.
Extend
Typ: long
Indikator dafür, wie die Verschiebung des Bereichs endet, ist, um fortzufahren. Dies kann eine der folgenden Sein.
0 oder tomMove | Reduziert einen nicht entarteten Bereich bis zum Ende des ursprünglichen Bereichs, indem die Einfügemarke verschoben wird. Dies ist die Standardoption. |
1 (oder tomExtend) | Verschiebt Das Ende zum Ende der sich überlappenden Einheit. Start wird nicht verschoben. |
pDelta
Typ: long*
Die Anzahl der Zeichen, an denen End verschoben wird. Der Wert des Zeigers kann NULL sein. Bei der Rückgabe ist der Wert von pDelta die Anzahl der Zeichen, die die Einfügemarke oder Das Ende verschoben wird , plus 1, wenn ein Reduzieren auf den Eintrag End auftritt. Wenn der Bereich die endgültige CR (Wagenrücklauf) (am Ende des Storys) und Extend = tomMove enthält, wird pDelta auf -1 festgelegt, um anzugeben, dass der Zusammenbruch vor dem Ende des Bereichs aufgetreten ist (da eine Einfügemarke nicht über die endgültige CR hinaus bestehen kann).
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
Zum Vergleich verschiebt die ITextRange::StartOf-Methode den Bereich an den Anfang der ersten sich überlappenden Einheit im Bereich. Beachten Sie, dass sich die Methoden ITextRange::StartOf und ITextRange::EndOf von den HomeKey - und EndKey-Methoden dadurch unterscheiden, dass letztere vom aktiven Ende aus erweitert werden, während ITextRange::StartOf von Start und ITextRange::EndOf von End aus erweitert wird. Wenn es sich bei dem Bereich um eine Einfügemarke an einer Grenze zwischen Einheits handelt, ändert ITextRange::EndOf nicht End. Insbesondere das Aufrufen von ITextRange::EndOf (tomCharacter, *, *) ändert Das Ende mit Ausnahme einer Einfügemarke am Anfang einer Geschichte nicht.
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