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

Artigo
03/09/2024

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