Método ITextStoreAnchor::QueryInsert (texttor.h)

El método ITextStoreAnchor::QueryInsert determina si los delimitadores inicial y final especificados son válidos. Use este método para ajustar una edición a un documento antes de ejecutar la edición. El método no debe devolver valores fuera del intervalo del documento.

Sintaxis

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Parámetros

[in] paTestStart

Recibe un puntero a un delimitador inicial para el texto insertado.

[in] paTestEnd

Recibe un puntero a un delimitador final para el texto insertado. Esto es lo mismo que paTestStart si el texto se inserta en un punto en lugar de reemplazar el texto seleccionado.

[in] cch

Longitud del texto de reemplazo.

[out] ppaResultStart

Puntero al nuevo objeto de anclaje en la ubicación inicial del texto insertado. Si el valor de este parámetro es NULL, el texto no se puede insertar en la posición especificada. Este delimitador no puede estar fuera del documento.

[out] ppaResultEnd

Puntero al nuevo objeto de anclaje en la ubicación final del texto insertado. Si el valor de este parámetro es NULL, el texto no se puede insertar en la posición especificada. Este delimitador no puede estar fuera del documento.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Los parámetros paTestStart o paTestEnd no son válidos.
E_OUTOFMEMORY	Error al intentar crear una instancia de los anclajes ppaResultStart o ppaResultEnd .

Comentarios

Los valores de ppaResultStart y ppaResultEnd dependen de cómo la aplicación inserta texto en el documento. Si ppaResultStart y ppaResultEnd son los mismos que paTestStart, el cursor se encuentra al principio del texto insertado después de la inserción. Si ppaResultStart y ppaResultEnd son iguales que paTextEnd, el cursor se encuentra al final del texto insertado después de la inserción.

Requisitos

Requisito	Value
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