Função ScriptGetFontFeatureTags (usp10.h)
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.
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 |