Función ScriptApplyLogicalWidth (usp10.h)

Artículo
08/26/2023

Toma una matriz de anchos avanzados para una ejecución y genera una matriz de anchos de glifos avanzados ajustados.

Sintaxis

HRESULT ScriptApplyLogicalWidth(
  [in]                const int             *piDx,
  [in]                int                   cChars,
  [in]                int                   cGlyphs,
  [in]                const WORD            *pwLogClust,
  [in]                const SCRIPT_VISATTR  *psva,
  [in]                const int             *piAdvance,
  [in]                const SCRIPT_ANALYSIS *psa,
  [in, out, optional] ABC                   *pABC,
  [out]               int                   *piJustify
);

Parámetros

[in] piDx

Puntero a una matriz de anchos avanzados en orden lógico, uno por punto de código.

[in] cChars

Recuento de los puntos de código lógico de la ejecución.

[in] cGlyphs

Recuento de glifos.

[in] pwLogClust

Puntero a una matriz de clústeres lógicos de ScriptShape.

[in] psva

Puntero a una estructura de SCRIPT_VISATTR de ScriptShape y actualizada por ScriptPlace.

[in] piAdvance

Puntero a una matriz de anchos avanzados de glifo de ScriptPlace.

[in] psa

Puntero a una estructura de SCRIPT_ANALYSIS de ScriptItemize y actualizada por ScriptShape y ScriptPlace.

[in, out, optional] pABC

Puntero al ancho abc general de una ejecución. En la entrada, el parámetro debe contener los anchos ABC de ejecución recuperados por ScriptPlace. En la salida, el parámetro indica el ancho ABC actualizado para que coincida con los nuevos anchos.

[out] piJustify

Puntero a una matriz en la que la función recupera los anchos de avance del glifo. Esta matriz es adecuada para pasar al parámetro piJustify de ScriptTextOut.

Valor devuelto

Si la operación se realiza correctamente, devuelve 0. 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

Esta función se puede usar para volver a aplicar los anchos lógicos obtenidos con ScriptGetLogicalWidths. Puede ser útil en situaciones como la metafiling, para las que se debe registrar y volver a aplicar información de ancho avanzado de manera independiente de la fuente, independientemente de las sustituciones del glifo, como la ligaturización.

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