Compartir a través de


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

El método ITfInsertAtSelection::InsertEmbeddedAtSelection inserta un objeto IDataObject en el punto de selección o inserción.

Sintaxis

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

Parámetros

[in] ec

Identifica el contexto de edición. Esto se obtiene de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dwFlags

Campo de bits con uno de los valores siguientes:

TF_IAS_NOQUERY

El parámetro ppRange es NULL al salir.

TF_IAS_QUERYONLY

El contexto no se modifica, pero el parámetro ppRange se establece como si se produjera la inserción. El acceso de solo lectura es suficiente. Si no se establece esta marca, el parámetro ec debe tener acceso de lectura y escritura.

TF_IAS_NO_DEFAULT_COMPOSITION

El administrador de TSF no crea una composición predeterminada si se requiere una composición. El autor de la llamada debe crear un objeto de composición que cubra el texto insertado antes de liberar el bloqueo de contexto.

[in] pDataObject

Puntero al objeto que se va a insertar.

[out] ppRange

Posición del objeto insertado. Opcional.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
Método realizado correctamente.
TF_E_NOLOCK
El parámetro ec es una cookie de edición no válida.
TF_E_DISCONNECTED
El objeto context no está en una pila de documentos.
TS_E_NOSELECTION
El contexto no tiene ninguna selección.
TS_E_READONLY
La selección es de solo lectura.
TF_E_FORMAT
El propietario del contexto no puede controlar objetos del tipo proporcionado por el parámetro pDataObject .

Comentarios

Los autores de llamadas pueden usar el método ITfQueryEmbedded::QueryInsertEmbedded para determinar si es probable que este método acepte un tipo de objeto determinado.

Para insertar texto en lugar de un objeto IDataObject , use el método ITfInsertAtSelection::InsertTextAtSelection .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

IDataObject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded