Uso de las funciones ScriptString

  • Artículo

Para una aplicación que trata con texto sin formato, Uniscribe proporciona las funciones ScriptString* . Estas funciones son similares a ExtTextOut, DrawText y GetTextExtent, pero proporcionan compatibilidad completa con scripts complejos, incluida la colocación de intercalación. Estas funciones son similares a las otras funciones Uniscribe, pero se adaptan a los requisitos más sencillos del procesamiento de texto sin formato.

En la tabla siguiente se detallan las funciones ScriptString* y cualquier homólogo de las demás funciones Uniscribe.

Función Descripción
ScriptStringAnalyse Analiza el texto sin formato. Esta función corresponde a las siguientes funciones:
ScriptItemize
ScriptShape
ScriptPlace
ScriptBreak
ScriptGetCMap
ScriptJustify
ScriptLayout
ScriptStringCPtoX Recupera la coordenada x de una posición de carácter. Esta función corresponde a ScriptCPtoX.
ScriptStringFree Libera una estructura SCRIPT_STRING_ANALYSIS .
ScriptStringGetLogicalWidths Convierte los anchos visuales en anchos lógicos. Esta función corresponde a ScriptGetLogicalWidths.
ScriptStringGetOrder Asigna posiciones de glifo de caracteres de forma similar a GetCharacterPlacement, solo para uso heredado. Esta función no funciona bien con scripts que generan más de un glifo por punto de código.
ScriptStringOut Muestra texto sin formato. Esta función corresponde a ScriptTextOut.
ScriptString_pcOutChars Devuelve un puntero a la longitud de una cadena de texto sin formato recortada.
ScriptString_pLogAttr Devuelve un puntero al búfer de atributos lógicos para una cadena de texto sin formato analizada.
ScriptString_pSize Devuelve un puntero al tamaño (ancho y alto) de una cadena de texto sin formato analizada.
ScriptStringValidate Identifica secuencias de punto de código no válidas en el script especificado. Esta función es diferente de ScriptGetCMap, que identifica los puntos de código que no están presentes en una fuente.
ScriptStringXtoCP Convierte una coordenada x en una posición de carácter. Esta función corresponde a ScriptXtoCP.

Para mostrar solo texto sin formato sin modificaciones, una aplicación debe llamar a ScriptStringAnalyse, ScriptStringOut y, a continuación, ScriptStringFree. Las demás funciones se usan para modificar el texto sin formato antes de mostrarse.

Uso de Uniscribe