Função ScriptSubstituteSingleGlyph (usp10.h)

Artigo
03/03/2024

Habilita a substituição de um único glifo por uma forma alternativa do mesmo glifo para processamento OpenType.

Sintaxe

HRESULT ScriptSubstituteSingleGlyph(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           OPENTYPE_TAG    tagFeature,
  [in]           LONG            lParameter,
  [in]           WORD            wGlyphId,
  [out]          WORD            *pwOutGlyphId
);

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 indicando 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 o glifo substituto correto seja usado.

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 para formatação.

[in] tagLangSys

Uma estrutura OPENTYPE_TAG definindo a marca de idioma para formatação.

[in] tagFeature

Uma estrutura OPENTYPE_TAG definindo a marca de recurso a ser usada para formatação do glifo alternativo.

[in] lParameter

Referência ao glifo alternativo a ser substituído. Essa referência é um índice para uma matriz que contém todos os glifos alternativos definidos no recurso, conforme ilustrado para OPENTYPE_FEATURE_RECORD. A matriz de glifo alternativo é um dos itens recuperados por ScriptGetFontAlternateGlyphs.

[in] wGlyphId

Identificador do glifo original.

[out] pwOutGlyphId

Ponteiro para o local em que essa função recupera o identificador do glifo alternativo.

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 .

Comentários

Essa função usa substituição um-para-um na qual o aplicativo pode substituir um glifo por um formulário alternativo. Na maioria das vezes, os aplicativos usam essa função para definir um marcador ou um glifo alternativo no início ou no final de uma linha.

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