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

Determina si las posiciones de caracteres inicial y final especificadas son válidas. 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]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parámetros

[in] acpTestStart

Iniciando la posición del carácter de la aplicación para el texto insertado.

[in] acpTestEnd

Posición final del carácter de la aplicación para el texto insertado. Este valor es igual a acpTextStart si el texto se inserta en un punto en lugar de reemplazar el texto seleccionado.

[in] cch

Longitud del texto de reemplazo.

[out] pacpResultStart

Devuelve la nueva posición de carácter de aplicación inicial del texto insertado. Si este parámetro es NULL, el texto no se puede insertar en la posición especificada. Este valor no puede estar fuera del intervalo de documentos.

[out] pacpResultEnd

Devuelve la nueva posición de carácter de aplicación final del texto insertado. Si este parámetro es NULL, pacpResultStart se establece en NULL y el texto no se puede insertar en la posición especificada. Este valor no puede estar fuera del intervalo de documentos.

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 acpTestStart o acpTestEnd no son válidos.

Comentarios

Los valores de pacpResultStart y pacpResultEnd dependen de cómo la aplicación inserta texto en el documento. Si pacpResultStart y pacpResultEnd son los mismos que acpTextStart, el cursor se encuentra al principio del texto insertado después de la inserción. Si pacpResultStart y pacpResultEnd son iguales que acpTextEnd, el cursor se encuentra al final del texto insertado después de la inserción. Si la diferencia entre pacpResultStart y pacpResultEnd es igual a la longitud del texto insertado, el texto insertado se resalta después de la inserción.

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

ITextStoreACP2