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

Artigo
08/24/2023

Move a âncora final do intervalo.

Sintaxe

HRESULT ShiftEnd(
  [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 que a âncora final é 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 que a âncora mudou.

[in] pHalt

Ponteiro para uma estrutura TF_HALTCOND que contém condições no turno. 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_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
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::ShiftEndRegion é usado para deslocar a âncora para uma região adjacente.

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

ITfRange::ShiftEnd pode ser uma operação longa. Para melhorar o desempenho, use ITfRange::ShiftEndToRange 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