Compartir a través de


Método ITextStoreAnchor::InsertEmbeddedAtSelection (textstor.h)

El método ITextStoreAnchor::InsertEmbeddedAtSelection inserta un objeto IDataObject en el punto de inserción o selección. El cliente que llama a este método debe tener un bloqueo de lectura y escritura antes de insertar un IDataObject en la secuencia de texto.

Sintaxis

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parámetros

[in] dwFlags

Especifica si los parámetros paStart y paEnd contendrán los resultados de la inserción de objetos.

No se pueden combinar las marcas TF_IAS_NOQUERY y TF_IAS_QUERYONLY.

Valor Significado
TF_IAS_NOQUERY
Se inserta texto y los valores de los parámetros ppaStart y ppaEnd pueden ser NULL. Use esta marca si los resultados de la inserción de texto no son necesarios.
TF_IAS_QUERYONLY
El texto no se inserta y los delimitadores ppaStart y ppaEnd contienen los resultados de la inserción de texto. Los valores de estos parámetros dependen de cómo implementa la aplicación la inserción de texto en un documento.

Use esta marca para ver los resultados de la inserción de texto sin insertar realmente el texto, por ejemplo, para predecir los resultados de contraer o ajustar una selección de otro modo.

[in] pDataObject

Puntero al objeto IDataObject que se va a insertar.

[out] ppaStart

Puntero al objeto delimitador al principio de la inserción del objeto.

[out] ppaEnd

Puntero al objeto delimitador al final de la inserción del objeto. Para un punto de inserción, este valor de parámetro será el mismo que el valor del parámetro ppaStart .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
Método realizado correctamente.
E_FAIL
El método no pudo crear una instancia de uno de los anclajes paStart o paEnd.
E_INVALIDARG
El parámetro pchText no es válido.
E_OUTOFMEMORY
El método no pudo crear una instancia de uno de los anclajes paStart o paEnd.
TS_E_NOLOCK
El autor de la llamada no tiene un bloqueo en el documento.

Comentarios

Los clientes deben usar este método para insertar un objeto en una secuencia de texto, ya que una constante TS_CHAR_EMBEDDED no se puede pasar a ITextStoreAnchor::SetText.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado textstor.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

IDataObject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbedded

ITextStoreAnchor::SetText

TF_IAS_* Constantes

TS_CHAR_EMBEDDED