ITextRange::SetStart-Methode (tom.h)

Artikel
08/26/2023

Legt die Zeichenposition für den Anfang dieses Bereichs fest.

Syntax

HRESULT SetStart(
  [in] long cpFirst
);

Parameter

[in] cpFirst

Typ: long

Die neue Zeichenposition für den Anfang des Bereichs.

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

Beachten Sie, dass, wenn cpFirst größer als die Endposition des Bereichs ist, diese Methode die Endposition gleich cpFirst festlegt, sodass der Bereich eine Einfügemarke ist. Wenn dieser Bereich die Auswahl ist, wird die Startposition zum aktiven Ende und wird in die Ansicht gescrollt, wenn die Anzeige nicht eingefroren ist.

ITextRange::SetEnd legt die Endposition des Bereichs fest, und ITextRange::SetRange legt beide Bereichsenden gleichzeitig fest. Das folgende Beispiel zeigt, wie ein nicht entartegenerierter Bereich in einen degenerten Bereich (Einfügemarke) konvertiert wird.

range.End = range.Start

range.Start = range.End Auf ähnliche Weise konvertiert der Bereich in eine Einfügemarke an der Endposition.

Im folgenden Beispiel wird der Endposition 1 hinzugefügt, wenn sie sich nicht am Ende des Storys befindet.

range.End = range.End + 1

Dadurch wird die Endposition auch zum aktiven Ende des Bereichs und kann einen entarteten Bereich in einen nicht entarteten Bereich umwandeln.

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