ITextRange::StartOf-Methode (tom.h)

Artikel
03/03/2024

Verschiebt den Bereichsende an den Anfang der ersten überlappenden Einheit im Bereich.

Syntax

HRESULT StartOf(
  long Unit,
  long Extend,
  long *pDelta
);

Parameter

Unit

Typ: long

Einheit, die im Verschiebungsvorgang verwendet werden soll. Eine Liste der Einheitenwerte finden Sie in der Diskussion unter ITextRange.

Extend

Typ: long

Verschieben der Enden des Bereichs. Dieses Argument einen der folgenden Werte annehmen.

0 (oder tomMove)	Reduziert einen nicht entgenerten Bereich auf die Startposition, indem die Einfügemarke verschoben wird. Dies ist die Standardoption.
1 (oder tomExtend)	Verschiebt die Startposition an den Anfang der überlappenden Einheit. Die Endposition wird nicht verschoben.

pDelta

Typ: long*

Zeiger auf eine Variable, die die Anzahl der Zeichen empfängt, für die die Startposition verschoben wird. Sie kann Null sein. Bei der Rückgabe ist pDelta die signierte Anzahl von Zeichen, die die Einfügemarke oder Startposition verschoben wird. Dieser Wert ist immer kleiner oder gleich 0, da die Bewegung immer zum Anfang der Geschichte führt.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. 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

Wenn der Bereich eine Einfügemarke an einer Grenze zwischen Einheitenist, ändert ITextRange::StartOf die Startposition nicht.

Die Methoden ITextRange::StartOf und ITextRange::EndOf unterscheiden sich von den HomeKey - und EndKey-Methoden darin, dass letztere vom aktiven Ende aus erweitert werden, während ITextRange::StartOf von der Startposition und ITextRange::EndOf von der Endposition aus erweitert wird.

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