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

Artículo
03/03/2024

Mueve el intervalo hasta el principio de la primera unidad superpuesta en el intervalo.

Sintaxis

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

Parámetros

Unit

Tipo: long

Unidad que se va a usar en la operación de movimiento. Para obtener una lista de valores de unidad , vea la discusión en ITextRange.

Extend

Tipo: long

Cómo mover los extremos del intervalo. Puede ser uno de los siguientes valores.

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

pDelta

Tipo: long*

Puntero a una variable que recibe el número de caracteres que se mueve la posición inicial. Puede ser NULL. En la devolución, pDelta es el número de caracteres con signo que se mueve el punto de inserción o la posición inicial. Este valor siempre es menor o igual que cero, porque el movimiento siempre está hacia el principio de la historia.

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 alguna otra razón.

Comentarios

Si el intervalo es un punto de inserción en un límite entre la unidads, ITextRange::StartOf no cambia la posición inicial.

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 la posición inicial e ITextRange::EndOf se extiende desde la posición final.

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