Compartir a través de

Función ScriptStringGetOrder (usp10.h)

  • Artículo

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

Consulte también

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

ScriptString_pcOutChars

Uniscribe

Funciones de uniscribe