Método ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Artigo
08/24/2023

O método ITfInsertAtSelection::InsertEmbeddedAtSelection insere um objeto IDataObject no ponto de seleção ou inserção.

Sintaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

Parâmetros

[in] ec

Identifica o contexto de edição. Isso é obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] dwFlags

Campo de bits com um dos seguintes valores:

TF_IAS_NOQUERY

O parâmetro ppRange é NULL na saída.

TF_IAS_QUERYONLY

O contexto não é modificado, mas o parâmetro ppRange é definido como se a inserção tivesse ocorrido. O acesso somente leitura é suficiente. Se esse sinalizador não estiver definido, o parâmetro ec deverá ter acesso de leitura/gravação.

TF_IAS_NO_DEFAULT_COMPOSITION

O gerenciador do TSF não criará uma composição padrão se uma composição for necessária. O chamador deve criar um objeto de composição que abrange o texto inserido antes de liberar o bloqueio de contexto.

[in] pDataObject

Ponteiro para o objeto a ser inserido.

[out] ppRange

Posição do objeto inserido. Opcional.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
TF_E_NOLOCK	O parâmetro ec é um cookie de edição inválido.
TF_E_DISCONNECTED	O objeto de contexto não está em uma pilha de documentos.
TS_E_NOSELECTION	O contexto não tem seleção.
TS_E_READONLY	A seleção é somente leitura.
TF_E_FORMAT	O proprietário do contexto não pode manipular objetos do tipo fornecidos pelo parâmetro pDataObject .

Comentários

Os chamadores podem usar o método ITfQueryEmbedded::QueryInsertEmbedded para determinar se um tipo de objeto específico provavelmente será aceito por esse método.

Para inserir texto em vez de um objeto IDataObject , use o método ITfInsertAtSelection::InsertTextAtSelection .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional