Compartir a través de


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

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

Consulte también

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEnd

ITfRange::ShiftStartRegion

ITfRange::ShiftStartToRange

TF_HALTCOND