Compartir a través de

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

  • Artículo

Inserta un 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 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado textstor.h
Archivo DLL Msctf.dll

Consulte también

IDataObject

ITextStoreACP2

TF_IAS_* Constantes

TS_TEXTCHANGE