Função ScriptStringGetOrder (usp10.h)

  • Artigo

Cria uma matriz que mapeia uma posição de caractere original para uma posição de glifo.

Sintaxe

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

Parâmetros

[in] ssa

Uma estrutura SCRIPT_STRING_ANALYSIS para a cadeia de caracteres.

[out] puOrder

Ponteiro para um buffer no qual essa função recupera uma matriz de posições de glifo, indexada pela posição do caractere original. A matriz deve ter espaço para pelo menos o número de inteiros indicado pelo parâmetro ssa de ScriptString_pcOutChars.

Valor retornado

Retorna S_OK se tiver êxito. 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

Quando o número de glifos e o número de caracteres são iguais, a função recupera uma matriz que faz referência a cada glifo. Esse é o mesmo tratamento que ocorre em GetCharacterPlacement.

Para usar essa função, o aplicativo precisa especificar SSA_GLYPHS em sua chamada original para ScriptStringAnalyse.

Importante A partir do 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

   
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_STRING_ANALYSIS

Scriptstringanalyse

ScriptString_pcOutChars

Uniscribe

Funções Uniscribe