ITextRange::MoveEndUntil-Methode (tom.h)

Artikel
08/26/2023

Verschiebt das Ende des Bereichs auf die Zeichenposition des ersten gefundenen Zeichens, das sich in dem von Cset angegebenen Zeichensatz befindet, vorausgesetzt, das Zeichen befindet sich in Anzahlzeichen am Ende des Bereichs.

Syntax

HRESULT MoveEndUntil(
  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, an die sich zu verschieben ist. Der Standardwert ist tomForward, der bis zum Ende des Storys sucht. Wenn Count größer als 0 ist, wird die Suche vorwärts (gegen Ende der Geschichte) verschoben. Wenn Count kleiner als 0 ist, wird die Suche rückwärts (zum Anfang der Geschichte) verschoben. Wenn Count 0 ist, bleibt die Endposition unverändert.

pDelta

Typ: long*

Die tatsächliche Anzahl von Zeichen, die am Ende des Bereichs verschoben werden, 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, gibt sie S_OK zurück. 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
Wert	Bedeutung
E_INVALIDARG	Cset ist ungültig.
S_FALSE	Fehler aus einem anderen Grund.

Hinweise

Wenn kein Zeichen aus dem von Cset angegebenen Satz in den Count-Positionen des Bereichs am Ende des Bereichs gefunden wird, bleibt der Bereich unverändert. Wenn das neue Ende dem alten Start vorangeht, wird der neue Start gleich dem neuen Ende festgelegt.

Die von ITextRange::MoveEndUntil beschriebene Bewegung ist logisch und nicht geometrisch. Das heißt, Bewegung geht zum Ende oder zum Anfang einer Geschichte. Je nach Sprache kann der Wechsel zum Ende der Geschichte nach links oder 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