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

Artigo
08/24/2023

Move a âncora inicial do intervalo.

Sintaxe

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

Parâmetros

[in] ec

Contém um cookie de edição que identifica o contexto de edição. Isso é obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] cchReq

Contém o número de caracteres em que a âncora inicial é deslocada. Um valor negativo faz com que a âncora se mova para trás e um valor positivo faz com que a âncora avance.

[out] pcch

Ponteiro para um valor LONG que recebe o número de caracteres em que a âncora foi deslocada.

[in] pHalt

Ponteiro para uma estrutura TF_HALTCOND que contém condições sobre a mudança. Esse parâmetro é opcional e pode ser NULL.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_FAIL	Ocorreu um erro não especificado.
TF_E_NOLOCK	O contexto de edição identificado por ec não tem um bloqueio somente leitura.

Comentários

As posições inicial e final de um intervalo são chamadas de âncoras.

Esse método não pode mover uma âncora além de um limite de região. Se a mudança atingir um limite de região, o número de caracteres realmente deslocados será menor do que o solicitado. ITfRange::ShiftStartRegion é usado para deslocar a âncora para uma região adjacente.

Se a operação de deslocamento fizer com que a âncora inicial do intervalo passe da âncora final, a âncora final será movida para o mesmo local que a âncora inicial.

ITfRange::ShiftStart pode ser uma operação longa. Para melhorar o desempenho, use ITfRange::ShiftStartToRange quando possível.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional