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

Artículo
03/05/2024

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