Compartir a través de

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

  • Artículo

El método ITextStoreACP::InsertTextAtSelection inserta texto en el punto de inserción o selección. Un llamador debe tener un bloqueo de lectura y escritura en el documento antes de insertar texto.

Sintaxis

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [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 contienen los resultados de la inserción de texto.

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 para ver los resultados de la inserción de texto.
TF_IAS_QUERYONLY
 El texto no se inserta y los valores de los parámetros 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. No es necesario rellenar la estructura de TS_TEXTCHANGE si usa esta marca.

[in] pchText

Puntero a la cadena que se va a insertar en el documento. La cadena puede terminarse en NULL .

[in] cch

Especifica la longitud del texto.

[out] pacpStart

Puntero a la posición del carácter de la aplicación inicial donde se produce la inserción de texto.

[out] pacpEnd

Puntero a la posición del carácter de la aplicación final donde se produce la inserción de texto. Este valor de parámetro es 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 texto en el documento.
acpOldEnd
 Posición del carácter final de la aplicación antes de insertar el texto 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 de texto.
acpNewEnd
 Posición final después de que se haya producido la inserción de texto.

Valor devuelto

Este método puede devolver uno de estos valores.

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

Comentarios

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

Las aplicaciones no deben llamar al método ITextStoreACPSink::OnTextChange en respuesta a este método.

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

Composiciones

ITextStoreACP

ITextStoreACPSink::OnTextChange

TF_IAS_* Constantes

TS_TEXTCHANGE