Função ScriptGetLogicalWidths (usp10.h)

  • Artigo

Converte as larguras de avanço do glifo para uma fonte específica em larguras lógicas.

Sintaxe

HRESULT ScriptGetLogicalWidths(
  [in]  const SCRIPT_ANALYSIS *psa,
  [in]  int                   cChars,
  [in]  int                   cGlyphs,
  [in]  const int             *piGlyphWidth,
  [in]  const WORD            *pwLogClust,
  [in]  const SCRIPT_VISATTR  *psva,
  [out] int                   *piDx
);

Parâmetros

[in] psa

Ponteiro para uma estrutura SCRIPT_ANALYSIS .

[in] cChars

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

[in] cGlyphs

Contagem dos glifos na execução.

[in] piGlyphWidth

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

[in] pwLogClust

Ponteiro para uma matriz de clusters lógicos.

[in] psva

Ponteiro para uma estrutura SCRIPT_VISATTR definindo atributos visuais.

[out] piDx

Ponteiro para uma matriz de larguras lógicas.

Retornar valor

Atualmente, retorna S_OK em todos os casos.

Comentários

Essa função é útil para registrar larguras de maneira independente da fonte. Ele converte as larguras de avanço do glifo calculadas para uma fonte específica em larguras lógicas, uma por ponto de código, na mesma ordem que os pontos de código. Se a mesma cadeia de caracteres for exibida em um dispositivo diferente usando uma fonte diferente, as larguras lógicas poderão ser aplicadas usando ScriptApplyLogicalWidth para aproximar o posicionamento original. Esse mecanismo é útil ao implementar a visualização de impressão. Na tela de visualização, é importante corresponder ao layout e ao posicionamento do resultado final impresso.

Nota As larguras de glifo de ligatura são divididas uniformemente entre os caracteres que representam.
 
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

Confira também

SCRIPT_ANALYSIS

SCRIPT_VISATTR

ScriptApplyLogicalWidth

Uniscribe

Funções Uniscribe