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

Artículo
03/13/2024

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.

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