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

Artículo
03/08/2023

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