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

Artigo
08/24/2023

O método ITfRange::InsertEmbedded insere um objeto no local da âncora inicial do intervalo de texto.

Sintaxe

HRESULT InsertEmbedded(
  [in] TfEditCookie ec,
  [in] DWORD        dwFlags,
  [in] IDataObject  *pDataObject
);

Parâmetros

[in] ec

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

[in] dwFlags

Campos de bits que especificam como a inserção deve ocorrer. Se TF_IE_CORRECTION estiver definido, a operação será uma correção, para que outros serviços de texto possam preservar os dados associados ao texto original.

[in] pDataObject

Ponteiro para o objeto de transferência de dados a ser inserido.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_NOTIMPL	O aplicativo de implementação não expõe objetos inseridos em seu fluxo.
TF_E_COMPOSITION_REJECTED	O proprietário do contexto rejeitou uma composição padrão.
TF_E_FORMAT	O proprietário do contexto não pode lidar com o tipo de objeto especificado.
TF_E_NOLOCK	O valor do parâmetro ec é um cookie inválido ou o chamador não tem um bloqueio somente leitura.
TF_E_RANGE_NOT_COVERED	O chamador já tem uma composição ativa, mas o intervalo é posicionado sobre o texto não coberto pela composição.
TF_E_READONLY	O documento ou o local do intervalo não podem ser modificados.

Comentários

Use esse método para inserir objetos no fluxo de texto, pois o TF_CHAR_EMBEDDED caractere de espaço reservado do objeto não pode ser passado para ITfRange::SetText. Esse método é modelado após a API da área de transferência OLE, com aplicativos usando pDataObject como fariam com um IDataObject retornado de OleGetClipboard.

Quando um intervalo abrange várias regiões, o método deve ser chamado em cada região separadamente. Caso contrário, o método poderá falhar.

Por padrão, os serviços de texto iniciam e encerram uma composição temporária que abrange o intervalo, para garantir que os proprietários de contexto reconheçam consistentemente composições em texto editado. Se o proprietário da composição rejeitar uma composição padrão, o método retornará TF_E_COMPOSITION_REJECTED. As composições padrão só serão criadas se o chamador ainda não tiver iniciado um. Se o chamador tiver uma composição ativa, a chamada falhará.

Para determinar com antecedência se um proprietário de contexto dá suporte à inserção de um objeto específico, use ITfQueryEmbedded::QueryInsertEmbedded.

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