Compartilhar via

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

Move a âncora inicial desse intervalo para uma âncora dentro de outro intervalo.

Sintaxe

HRESULT ShiftStartToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

Parâmetros

[in] ec

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

[in] pRange

Ponteiro para uma interface ITfRange que contém a âncora para a qual a âncora inicial é movida.

[in] aPos

Contém um dos valores TfAnchor que especifica para qual âncora de pRange a âncora inicial é movida.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 pRange é inválido.
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.

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.

Esse método é mais eficiente do que ITfRange::ShiftStart e deve ser usado quando possível.

Requisitos

Requisito Valor
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

Confira também

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEndToRange

ITfRange::ShiftStart

TfAnchor

  • Last updated on