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

Artículo
03/03/2024

Establece la posición final del intervalo.

Sintaxis

HRESULT SetEnd(
  long cpLim
);

Parámetros

cpLim

Tipo: long

Nueva posición 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 S_FALSE.

Comentarios

Si la nueva posición final es menor que la posición inicial, este método también establece la posición inicial en cp; es decir, el intervalo se convierte en un punto de inserción.

Si este intervalo es realmente la selección, la posición final se convierte en el extremo activo y, si la pantalla no está inmovilizada, se desplaza hacia la vista.

ITextRange::SetStart establece la posición inicial del intervalo y ITextRange::SetRange establece ambos extremos de intervalo simultáneamente. Para convertir un intervalo no degenerado, r, en uno degenerado (punto de inserción) en la posición inicial, use

r.End = r.Start

Del mismo modo, r.Start = r.End convierte r en un punto de inserción en la posición final.

Para agregar 1 a la posición final, a menos que esté al final del artículo, use:

r.End = r.End + 1

Esto también hace que la posición final sea el extremo activo y puede convertir un intervalo degenerado en uno no degenerado.

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