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

Artículo
03/13/2024

Mueve los extremos de este intervalo al final de la última unidad superpuesta del intervalo.

Sintaxis

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

Parámetros

Unit

Tipo: long

Unidad que se va a usar. Valor predeterminado: tomWord. Para obtener una lista de los otros valores unit , vea la discusión en ITextRange.

Extend

Tipo: long

Indicador de cómo se va a continuar el cambio del intervalo. Puede ser uno de los siguientes.

0 o tomMove	Contrae un intervalo no degenerado hasta el final del intervalo original moviendo el punto de inserción. Este es el valor predeterminado.
1 (o tomExtend)	Mueve End al final de la unidad superpuesta. No mueve Start.

pDelta

Tipo: long*

Recuento de caracteres que End se mueve más allá. El valor del puntero puede ser NULL. Al devolver, el valor de pDelta es el número de caracteres que el punto de inserción o End se mueve más 1 si se produce un colapso en la entrada End. Si el intervalo incluye la CR final (retorno de carro) (al final del artículo) y Extend = tomMove, pDelta se establece en –1, para indicar que el colapso se produjo antes del final del intervalo (porque un punto de inserción no puede existir más allá de la CR final).

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
E_NOTIMPL	No se admite la unidad.
S_FALSE	Error por algún otro motivo.

Comentarios

Para la comparación, el método ITextRange::StartOf mueve el intervalo finaliza al principio de la primera unidad superpuesta en el intervalo. Tenga en cuenta que los métodos ITextRange::StartOf e ITextRange::EndOf difieren de los métodos HomeKey y EndKey en que este último se extiende desde el extremo activo, mientras que ITextRange::StartOf se extiende desde Start e ITextRange::EndOf se extiende desde End. Si el intervalo es un punto de inserción en un límite entre units, ITextRange::EndOf no cambia End. En concreto, llamar a ITextRange::EndOf (tomCharacter, *, *) no cambia End excepto un punto de inserción al principio de un artículo.

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