ITextRange::MoveEndWhile-Methode (tom.h)
Verschiebt das Ende des Bereichs entweder Anzahlzeichen oder einfach über alle zusammenhängenden Zeichen, die sich in dem von Cset angegebenen Zeichensatz befinden, je nachdem, welcher Wert kleiner ist.
Syntax
HRESULT MoveEndWhile(
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 das Ende verschoben wird. 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 |
|---|---|
|
Cset ist ungültig. |
|
Fehler aus einem anderen Grund. |
Hinweise
Wenn das neue Ende dem alten Start vorangeht, wird der neue Start gleich dem neuen Ende festgelegt.
Die von ITextRange::MoveEndWhile beschriebene Bewegung ist eher logisch als 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
| 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