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

Artículo
08/26/2023

Inserta texto en el punto de inserción o selección.

Sintaxis

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [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 texto.

No se pueden combinar las marcas TF_IAS_NOQUERY y TF_IAS_QUERYONLY.

Value	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. Se puede insertar texto de longitud cero.

[in] pchText

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

[in] cch

Especifica la longitud del texto.

[out] ppaStart

Puntero al objeto delimitador al principio de la inserción de texto.

[out] ppaEnd

Puntero al objeto delimitador al final de la inserción de texto. 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.

Value	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.
TS_E_NOLOCK	El autor de la llamada no tiene un bloqueo en el documento.

Requisitos


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

Consulte también

Composiciones

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

TF_IAS_* Constantes

TS_TEXTCHANGE