ITextRange::EndOf-Methode (tom.h)

Artikel
08/26/2023

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
E_NOTIMPL	Unit wird nicht unterstützt.
S_FALSE	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