ITextRange::SetEnd-Methode (tom.h)

Artikel
03/06/2024

Legt die Endposition des Bereichs fest.

Syntax

HRESULT SetEnd(
  long cpLim
);

Parameter

cpLim

Typ: long

Die neue Endposition.

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 S_FALSE zurück.

Hinweise

Wenn die neue Endposition kleiner als die Startposition ist, legt diese Methode auch die Startposition auf cp fest; Das heißt, der Bereich wird zu einer Einfügemarke.

Wenn dieser Bereich tatsächlich die Auswahl ist, wird die Endposition zum aktiven Ende und, wenn die Anzeige nicht eingefroren ist, in die Ansicht gescrollt.

ITextRange::SetStart legt die Startposition des Bereichs fest, und ITextRange::SetRange legt beide Bereichsenden gleichzeitig fest. Verwenden Sie zum Konvertieren eines nicht entarteten Bereichs (r) in einen entarteten Bereich (Einfügemarke) an der Startposition.

r.End = r.Start

Ebenso konvertiert r.Start = r.End in eine Einfügemarke an der Endposition.

Um der Endposition 1 hinzuzufügen, es sei denn, sie befindet sich am Ende des Storys, verwenden Sie Folgendes:

r.End = r.End + 1

Dadurch wird auch die Endposition zum aktiven Ende, und es kann einen entarteten Bereich in einen nicht entarteten Bereich verwandeln.

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