Função ScriptGetFontLanguageTags (usp10.h)

Artigo
08/26/2023

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.

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 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