Función ScriptStringGetOrder (usp10.h)

Artículo
08/26/2023

Crea una matriz que asigna una posición de carácter original a una posición de glifo.

Sintaxis

HRESULT ScriptStringGetOrder(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] UINT                   *puOrder
);

Parámetros

[in] ssa

Estructura SCRIPT_STRING_ANALYSIS para la cadena.

[out] puOrder

Puntero a un búfer en el que esta función recupera una matriz de posiciones de glifo, indizada por la posición del carácter original. La matriz debe tener espacio para al menos el número de enteros indicados por el parámetro ssa de ScriptString_pcOutChars.

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 puede probar el valor devuelto con las macros SUCCEEDED y FAILED .

Comentarios

Cuando el número de glifos y el número de caracteres son iguales, la función recupera una matriz que hace referencia a cada glifo. Este es el mismo tratamiento que se produce en GetCharacterPlacement.

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

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


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
Redistribuible	Internet Explorer 5 o posterior en Windows Me/98/95