Método ITfRange::ShiftEnd (msctf.h)

Artículo
08/24/2023

Mueve el delimitador final del intervalo.

Sintaxis

HRESULT ShiftEnd(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Parámetros

[in] ec

Contiene una cookie de edición que identifica el contexto de edición. Esto se obtiene de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] cchReq

Contiene el número de caracteres que se desplaza el delimitador final. Un valor negativo hace que el delimitador se mueva hacia atrás y un valor positivo hace que el delimitador avance.

[out] pcch

Puntero a un valor LONG que recibe el número de caracteres que cambia el delimitador.

[in] pHalt

Puntero a una estructura de TF_HALTCOND que contiene condiciones en el desplazamiento. Este parámetro es opcional y puede ser NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Uno o varios parámetros no son válidos.
TF_E_NOLOCK	El contexto de edición identificado por ec no tiene un bloqueo de solo lectura.

Comentarios

Las posiciones inicial y final de un rango se denominan delimitadores.

Este método no puede mover un delimitador más allá de un límite de región. Si el desplazamiento alcanza un límite de región, el número de caracteres desplazados será menor que el solicitado. ITfRange::ShiftEndRegion se usa para desplazar el delimitador a una región adyacente.

Si la operación de desplazamiento hace que el delimitador final del intervalo se mueva más allá del delimitador inicial, el delimitador inicial se mueve a la misma ubicación que el delimitador final.

ITfRange::ShiftEnd puede ser una operación larga. Para mejorar el rendimiento, use ITfRange::ShiftEndToRange siempre que sea posible.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional