Função ScriptStringGetOrder (usp10.h)

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.

Requisitos

Confira também

SCRIPT_STRING_ANALYSIS

Scriptstringanalyse

ScriptString_pcOutChars

Uniscribe

Funções Uniscribe