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

Artículo
08/24/2023

Mueve el delimitador inicial del intervalo.

Sintaxis

HRESULT ShiftStart(
  [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 inicial. 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 se ha desplazado el delimitador.

[in] pHalt

Puntero a una estructura TF_HALTCOND que contiene condiciones sobre 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_INVALIDARG	Uno o varios parámetros no son válidos.
E_FAIL	Se ha producido un error no especificado.
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::ShiftStartRegion se usa para desplazar el delimitador a una región adyacente.

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

ITfRange::ShiftStart puede ser una operación larga. Para mejorar el rendimiento, use ITfRange::ShiftStartToRange 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