Função ScriptGetFontLanguageTags (usp10.h)
Recupera uma lista de marcas de idioma que estão disponíveis para o item especificado e têm suporte por uma marca de script especificada para processamento OpenType. As marcas que compõem a lista são recuperadas da fonte no cache ou no contexto do dispositivo especificado.
Sintaxe
HRESULT ScriptGetFontLanguageTags(
[in, optional] HDC hdc,
[in, out] SCRIPT_CACHE *psc,
[in, optional] SCRIPT_ANALYSIS *psa,
[in] OPENTYPE_TAG tagScript,
[in] int cMaxTags,
[out] OPENTYPE_TAG *pLangsysTags,
[out] int *pcTags
);
Parâmetros
[in, optional] hdc
Identificador para o contexto do dispositivo. Para obter mais informações, consulte Cache.
[in, out] psc
Ponteiro para uma estrutura SCRIPT_CACHE que identifica o cache de script.
[in, optional] psa
Ponteiro para uma estrutura SCRIPT_ANALYSIS obtida de uma chamada anterior para ScriptItemizeOpenType. Esse parâmetro identifica o mecanismo de formatação para que as marcas de idioma de fonte para a fonte e os scripts apropriados possam ser recuperados.
Como alternativa, o aplicativo pode definir esse parâmetro como NULL para recuperar resultados não filtrados.
[in] tagScript
Uma estrutura OPENTYPE_TAG que define a marca de script para a qual a lista de marcas de idioma associadas é solicitada.
[in] cMaxTags
O comprimento da matriz especificada por pLangSysTags.
[out] pLangsysTags
Ponteiro para um buffer no qual essa função recupera uma matriz de estruturas OPENTYPE_TAG identificando as marcas de idioma que correspondem aos critérios de entrada.
[out] pcTags
Ponteiro para o número de elementos na matriz de marcas de linguagem.
Valor retornado
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 .
Se o número de marcas correspondentes exceder cMaxTags, a função falhará com E_OUTOFMEMORY. O aplicativo pode tentar chamar novamente com buffers maiores.
Comentários
Embora formalmente declarada como um tipo ULONG, a estrutura OPENTYPE_TAG contém uma matriz de 4 bytes que contém quatro valores ASCII de 8 bits de espaço, A-Z ou a-z. Por exemplo, as marcas de idioma para romeno, urdu e persa são "ROM", "URD" e "FAR", respectivamente. Observe que cada marca termina com um espaço.
Requisitos
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | usp10.h |
Biblioteca | Usp10.lib |
DLL | Usp10.dll |
Redistribuível | Usp10.dll versão 1.600 ou superior no Windows XP |