Função ScriptApplyLogicalWidth (usp10.h)

Artigo
03/03/2024

Usa uma matriz de larguras avançadas para uma execução e gera uma matriz de larguras de glifo avançadas ajustadas.

Sintaxe

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

Ponteiro para uma matriz de larguras avançadas em ordem lógica, uma por ponto de código.

[in] cChars

Contagem dos pontos de código lógicos na execução.

[in] cGlyphs

Contagem de glifos.

[in] pwLogClust

Ponteiro para uma matriz de clusters lógicos de ScriptShape.

[in] psva

Ponteiro para uma estrutura SCRIPT_VISATTR de ScriptShape e atualizado por ScriptPlace.

[in] piAdvance

Ponteiro para uma matriz de larguras avançadas de glifo do ScriptPlace.

[in] psa

Ponteiro para uma estrutura SCRIPT_ANALYSIS de ScriptItemize e atualizada por ScriptShape e ScriptPlace.

[in, out, optional] pABC

Ponteiro para a largura geral do ABC de uma execução. Na entrada, o parâmetro deve conter as larguras abc de execução recuperadas por ScriptPlace. Na saída, o parâmetro indica a largura ABC atualizada para corresponder às novas larguras.

[out] piJustify

Ponteiro para uma matriz na qual a função recupera as larguras avançadas do glifo. Essa matriz é adequada para passar para o parâmetro piJustify de ScriptTextOut.

Retornar valor

Retorna 0 se for bem-sucedido. A função retornará um valor HRESULT diferente de zero se não for bem-sucedida. O aplicativo pode testar o valor retornado com as macros SUCCEEDED e FAILED .

Comentários

Essa função pode ser usada para reaplicar larguras lógicas obtidas com ScriptGetLogicalWidths. Pode ser útil em situações como metarquivo, para as quais as informações de largura avançada devem ser registradas e reaplicadas de maneira independente de fonte, independentemente de substituições de glifo, como ligaturização.

Importante Começando com Windows 8: para manter a capacidade de execução no Windows 7, um módulo que usa Uniscribe deve especificar Usp10.lib antes de gdi32.lib em sua lista de bibliotecas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	usp10.h
Biblioteca	Usp10.lib
DLL	Usp10.dll
Redistribuível	Internet Explorer 5 ou posterior no Windows Me/98/95