Método ITextStoreACP::InsertEmbeddedAtSelection (texttor.h)

El método ITextStoreACP::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 objeto IDataObject en el documento.

Sintaxis

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parámetros

[in] dwFlags

Especifica si los parámetros pacpStart y pacpEnd y la estructura TS_TEXTCHANGE contendrán los resultados de la inserción de objetos.

Las marcas TF_IAS_NOQUERY y TF_IAS_QUERYONLY no se pueden combinar.

Valor	Significado
0	Se producirá la inserción de texto y los parámetros pacpStart y pacpEnd contendrán los resultados de la inserción de texto. La estructura TS_TEXTCHANGE debe rellenarse con esta marca.
TF_IAS_NOQUERY	Se inserta texto, los valores de los parámetros pacpStart y pacpEnd pueden ser NULL y la estructura TS_TEXTCHANGE debe rellenarse. 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 valores del parámetro pacpStart y pacpEnd 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. Para obtener más información, vea la sección Comentarios. 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. No es necesario rellenar la estructura TS_TEXTCHANGE con esta marca.

[in] pDataObject

Puntero al objeto IDataObject que se va a insertar.

[out] pacpStart

Puntero a la posición del carácter de la aplicación inicial en la que se producirá la inserción del objeto.

[out] pacpEnd

Puntero a la posición del carácter de aplicación final donde se producirá la inserción del objeto. Este valor de parámetro será el mismo que el valor del parámetro pacpStart para un punto de inserción.

[out] pChange

Puntero a una estructura de TS_TEXTCHANGE con los siguientes miembros.

Valor	Significado
acpStart	Posición del carácter de aplicación inicial antes de insertar el objeto en el documento.
acpOldEnd	Posición del carácter de aplicación final antes de insertar el objeto en el documento. Este valor es el mismo que acpStart para un punto de inserción. Si este valor es diferente de acpStart, se seleccionó el texto antes de la inserción del objeto.
acpNewEnd	Posición del carácter de aplicación final después de que se haya realizado la inserción del objeto.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	El parámetro pchText no es válido.
TS_E_NOLOCK	El autor de la llamada no tiene un bloqueo en el documento.

Comentarios

Los valores de los parámetros pacpStart y pacpEnd dependen de cómo la aplicación cliente inserta un objeto en un documento. Por ejemplo, si la aplicación establece el cursor al principio del objeto después de la inserción de objetos, el valor de los parámetros pacpStart y pacpEnd es el mismo que el miembro acpStart de la estructura TS_TEXTCHANGE.

Requisitos

Requisito	Value
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	textstor.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

IDataObject

ITextStoreACP

TF_IAS_* Constantes

TS_TEXTCHANGE