Compartilhar via


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

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

Confira também

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded