Função ScriptGetFontFeatureTags (usp10.h)

Artigo
03/03/2024

Recupera uma lista de recursos tipográficos para o sistema de gravação definido para processamento OpenType. As marcas de recurso tipográficas que compõem a lista são recuperadas da fonte no contexto ou cache do dispositivo fornecido.

Sintaxe

HRESULT ScriptGetFontFeatureTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pFeatureTags,
  [out]          int             *pcTags
);

Parâmetros

[in, optional] hdc

Manipule 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 modelagem para que as marcas de recurso de fonte para a fonte e scripts apropriados possam ser recuperadas.

Como alternativa, o aplicativo pode definir esse parâmetro como NULL para recuperar resultados não filtrados.

[in] tagScript

Uma estrutura OPENTYPE_TAG definindo a marca de script associada às marcas de recurso especificadas.

[in] tagLangSys

Uma estrutura OPENTYPE_TAG definindo a marca de idioma associada às marcas de recurso especificadas.

[in] cMaxTags

O comprimento da matriz especificada por pFeatureTags.

[out] pFeatureTags

Ponteiro para um buffer no qual essa função recupera uma matriz de estruturas de OPENTYPE_TAG definindo as marcas de recurso tipográficas compatíveis com a fonte no contexto do dispositivo ou cache para o sistema de gravação definido.

[out] pcTags

Ponteiro para o número de elementos na matriz de marcas de recurso.

Retornar valor

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 o valor de 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, uma 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, a marca de recurso para o recurso Ligature é "liga".

Essa função oculta os recursos obrigatórios de script ou de linguagem porque o mecanismo de modelagem controla esses recursos. O aplicativo não tem controle sobre a manipulação do mecanismo de modelagem para recursos necessários à linguagem. Por exemplo, ScriptGetFontFeatureTags oculta os recursos de script árabe para formulários iniciais, mediais e finais.

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