Método ITextStoreACP::QueryInsert (textstor.h)
El método ITextStoreACP::QueryInsert 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
Posición del carácter de la aplicación inicial 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 |
---|---|
|
Método realizado correctamente. |
|
Se ha producido un error no especificado. |
|
Los parámetros acpTestStart o acpTestEnd no son válidos. |
Comentarios
Los valores de pacpResultStart y pacpResultEnd dependen de cómo inserta la aplicación 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 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 |