ITextRange::MoveStartUntil-Methode (tom.h)

Artikel
03/03/2024

Verschiebt die Startposition des Bereichs um die Position des ersten gefundenen Zeichens, das sich in der durch Cset angegebenen Zeichenmenge befindet, vorausgesetzt, dass das Zeichen unter Anzahl der Zeichen der Startposition gefunden wird.

Syntax

HRESULT MoveStartUntil(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Parameter

Cset

Typ: VARIANT*

Der Zeichensatz, der in der Übereinstimmung verwendet werden soll. Dies kann eine explizite Zeichenfolge oder ein Zeichensatzindex sein. Weitere Informationen finden Sie unter Zeichen-Übereinstimmungssätze.

Count

Typ: long

Maximale Anzahl von Zeichen, die in die Vergangenheit verschoben werden sollen. Der Standardwert ist tomForward, der bis zum Ende des Storys sucht. Wenn Count größer als 0 (null) ist, erfolgt die Suche vorwärts – zum Ende des Artikels – und wenn Count kleiner als 0 (null) ist, ist die Suche rückwärts zu Beginn. Wenn Count null ist, bleibt die Startposition unverändert.

pDelta

Typ: long*

Die tatsächliche Anzahl von Zeichen, die am Anfang des Bereichs verschoben wird, plus 1 für eine Übereinstimmung, wenn Count größer als 0 ist, und –1 für eine Übereinstimmung, wenn Count kleiner als 0 ist. Der Wert kann NULL sein.

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_INVALIDARG	Cset ist ungültig.
S_FALSE	Fehler aus einem anderen Grund.

Hinweise

Wenn kein Zeichen aus Cset innerhalb der Anzahl der Positionen der Startposition gefunden wird, bleibt der Bereich unverändert.

Wenn der neue Anfang dem alten Ende folgt, wird das neue Ende gleich dem neuen Anfang festgelegt.

Die von ITextRange::MoveStartUntil beschriebene Bewegung ist eher logisch als geometrisch. Das heißt, Bewegung ist gegen Ende oder zum Anfang einer Geschichte. Je nach Sprache kann der Wechsel zum Ende der Geschichte nach links oder nach rechts erfolgen.

Weitere Informationen finden Sie unter ITextRange und ITextRange::Move.

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