Compartir a través de


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

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

Consulte también

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEndRegion

ITfRange::ShiftStart

TF_HALTCOND