Compartilhar via


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

Move a âncora inicial de uma composição.

Sintaxe

HRESULT ShiftStart(
  [in] TfEditCookie ecWrite,
  [in] ITfRange     *pNewStart
);

Parâmetros

[in] ecWrite

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

[in] pNewStart

Ponteiro para um objeto ITfRange que contém a nova posição de âncora inicial. A âncora inicial do contexto será movida para a âncora inicial desse intervalo. Esse método falhará se a âncora inicial desse intervalo estiver posicionada além da âncora final da composição.

Retornar valor

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
A âncora inicial de pNewStart é posicionada após a âncora final da composição ou pNewStart é inválida.
E_UNEXPECTED
A composição já foi encerrada.
TF_E_NOLOCK
O contexto de edição identificado por ecWrite não tem um bloqueio de leitura/gravação.

Comentários

Esse método faz com que a propriedade GUID_PROP_COMPOSING seja removida de qualquer texto removido da composição. Da mesma forma, a propriedade GUID_PROP_COMPOSING também será adicionada a qualquer texto adicionado à composição.

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

Interface ITfComposition, ITfEditSession::D oEditSession, interface ITfRange, ITfComposition::ShiftEnd