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

Artigo
08/24/2023

O método ITfRange::AdjustForInsert expande ou contrai um intervalo de texto para ajustar para a inserção de texto.

Sintaxe

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

Parâmetros

[in] ec

Edite o cookie obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] cchInsert

Contagem de caracteres do texto inserido. Essa contagem é usada em uma chamada futura para ITfRange::SetText. Se a contagem de caracteres for desconhecida, 0 poderá ser usada.

[out] pfInsertOk

Ponteiro para um sinalizador que indica se o proprietário do contexto aceitará (TRUE) ou rejeitará (FALSE) a inserção.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	O método falhou.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_NOTIMPL	O aplicativo não pôde substituir a seleção.
TF_E_NOLOCK	O valor no parâmetro ec é um cookie inválido ou o chamador não tem um bloqueio somente leitura.

Comentários

Esse método deve ser usado para preparar um intervalo para iniciar uma nova composição, antes do início da edição. Ele só deve ser usado quando o texto não é inserido na seleção atual. ITFInsertAtSelection:InsertTextAtSelection ou ITfInsertAtSelection::InsertEmbeddedAtSelection são os métodos corretos a serem usados quando o texto é inserido na seleção atual.

O proprietário do contexto pode usar esse método para preservar o comportamento e ajudar a manter uma experiência de usuário consistente. Por exemplo, determinados caracteres ou objetos no contexto podem ser preservados de modificações ou pode haver suporte para sobretipagem.

Esse método não é necessário ao modificar uma composição existente. É aceitável chamar ITfRange::SetText diretamente para modificar o texto inserido anteriormente pelo chamador.

Na saída, se *pfInsertOk estiver definido como FALSE, uma chamada futura para ITfRange::SetText ou ITfRange::InsertEmbedded com esse intervalo provavelmente falhará. Caso contrário, *pfInsertOk será definido como TRUE e a âncora inicial do intervalo ou a âncora final podem ser reposicionadas a critério do proprietário do contexto.

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