Función ScriptStringOut (usp10.h)

Muestra una cadena generada por una llamada anterior a ScriptStringAnalyse y, opcionalmente, agrega resaltado.

Sintaxis

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

Parámetros

[in] ssa

Estructura SCRIPT_STRING_ANALYSIS para la cadena.

[in] iX

Coordenada x del punto de referencia utilizado para colocar la cadena.

[in] iY

Coordenada y del punto de referencia utilizado para colocar la cadena.

[in] uOptions

Opciones que especifican el uso del rectángulo definido por la aplicación. Este parámetro se puede establecer en 0 o en cualquiera de los valores siguientes. Los valores se pueden combinar con OR binario.

Valor	Significado
ETO_CLIPPED	Recorte el texto en el rectángulo.
ETO_OPAQUE	Use el color de fondo actual para rellenar el rectángulo.

[in, optional] prc

Puntero a una estructura RECT que define el rectángulo que se va a usar. Si uOptions se establece en ETO_OPAQUE y se proporciona NULL para prc, la función se realiza correctamente y devuelve S_OK. Sin embargo, si la aplicación establece uOptions en ETO_CLIPPING y proporciona NULL para prc, la función devuelve E_INVALIDARG. La aplicación puede establecer este parámetro en NULL para indicar que no se necesita ninguna opción.

[in] iMinSel

Índice de base cero que especifica la posición inicial en la cadena. Para ninguna selección, la aplicación debe establecer iMinSel>= iMaxSel.

[in] iMaxSel

Índice de base cero que especifica la posición final de la cadena.

[in] fDisabled

TRUE si el sistema operativo aplica resaltado de texto deshabilitado estableciendo el color de fondo en COLOR_HIGHLIGHT detrás de todos los caracteres seleccionados. La aplicación puede establecer este parámetro en FALSE si el sistema operativo aplica el resaltado de texto habilitado estableciendo el color de fondo en COLOR_HIGHLIGHT y el color de texto en COLOR_HIGHLIGHTTEXT para cada carácter seleccionado.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. La función devuelve un valor HRESULT distinto de cero si no se realiza correctamente. La aplicación no puede probar el valor devuelto con las macros SUCCEEDED y FAILED .

Comentarios

Para usar esta función, la aplicación debe especificar SSA_GLYPHS en su llamada original a ScriptStringAnalyse.

La aplicación no debe usar SetTextAlign con TA_UPDATECP cuando se usa ScriptStringOut porque el texto seleccionado no se puede representar correctamente. Si la aplicación debe usar esta marca, puede anular y restablecer la marca según sea necesario para evitar el problema.

Importante A partir de Windows 8: para mantener la capacidad de ejecutarse en Windows 7, un módulo que usa Uniscribe debe especificar Usp10.lib antes de gdi32.lib en su lista de bibliotecas.

 

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	usp10.h
Library	Usp10.lib
Archivo DLL	Usp10.dll

Consulte también

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Funciones de uniscribe