ITextRange::SetStart-Methode (tom.h)
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 |
Siehe auch
Konzept
Referenz