Método ITextRange::MoveEndUntil (tom.h)

Artículo
03/03/2024

Mueve el extremo del intervalo a la posición de carácter del primer carácter que se encuentra en el conjunto de caracteres especificado por Cset, siempre que el carácter se encuentre dentro de los caracteres Count del final del intervalo.

Sintaxis

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

Parámetros

Cset

Tipo: VARIANT*

Juego de caracteres que se va a usar en la coincidencia. Podría tratarse de una cadena explícita de caracteres o un índice de juego de caracteres. Para obtener más información, vea Juegos de coincidencias de caracteres.

Count

Tipo: long

Número máximo de caracteres que se van a mover más allá. El valor predeterminado es tomForward, que busca al final del artículo. Si Count es mayor que cero, la búsqueda avanza (hacia el final del artículo). Si Count es menor que cero, la búsqueda se mueve hacia atrás (hacia el principio del artículo). Si Count es cero, la posición final no cambia.

pDelta

Tipo: long*

Número real de caracteres que se mueve el extremo del intervalo, más 1 para una coincidencia si Count es mayor que cero y –1 para una coincidencia si Count es menor que cero. El valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
Valor	Significado
E_INVALIDARG	Cset no es válido.
S_FALSE	Error por alguna otra razón.

Comentarios

Si no se encuentra ningún carácter del conjunto especificado por Cset dentro de las posiciones Count del final del intervalo, el intervalo se deja sin cambios. Si el nuevo final precede al inicio anterior, el nuevo inicio se establece igual al nuevo final.

El movimiento descrito por ITextRange::MoveEndUntil es lógico en lugar de geométrico. Es decir, el movimiento está hacia el final o hacia el inicio de una historia. Dependiendo del idioma, pasar al final de la historia podría estar moviéndose a la izquierda o moviéndose a la derecha.

Para obtener más información, vea ITextRange e ITextRange::Move.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll