Funzione ScriptSubstituteSingleGlyph (usp10.h)

Articolo
03/13/2024

Abilita la sostituzione di un singolo glifo con una forma alternativa dello stesso glifo per l'elaborazione di OpenType.

Sintassi

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

Parametri

[in, optional] hdc

Gestire il contesto del dispositivo. Per altre informazioni, vedere Memorizzazione nella cache.

[in, out] psc

Puntatore a una struttura SCRIPT_CACHE che indica la cache degli script.

[in, optional] psa

Puntatore a una struttura SCRIPT_ANALYSIS ottenuta da una chiamata precedente a ScriptItemizeOpenType. Questo parametro identifica il motore di forma in modo che venga usato il glifo sostitutivo corretto.

In alternativa, l'applicazione può impostare questo parametro su NULL per recuperare risultati non filtrati.

[in] tagScript

Struttura OPENTYPE_TAG che definisce il tag di script per la modellazione.

[in] tagLangSys

Struttura OPENTYPE_TAG che definisce il tag di lingua per la forma.

[in] tagFeature

Struttura OPENTYPE_TAG che definisce il tag di funzionalità da usare per modellare il glifo alternativo.

[in] lParameter

Riferimento al glifo alternativo da sostituire. Questo riferimento è un indice a una matrice che contiene tutti gli glifi alternativi definiti nella funzionalità, come illustrato per OPENTYPE_FEATURE_RECORD. La matrice di glifi alternativi è uno degli elementi recuperati da ScriptGetFontAlternateGlyphs.

[in] wGlyphId

Identificatore del glifo originale.

[out] pwOutGlyphId

Puntatore alla posizione in cui questa funzione recupera l'identificatore del glifo alternativo.

Valore restituito

Restituisce 0 in caso di esito positivo. La funzione restituisce un valore HRESULT diverso da zero se non riesce. L'applicazione può testare il valore restituito con le macro SUCCESSED e FAILED .

Commenti

Questa funzione usa una sostituzione uno-a-uno in cui l'applicazione può sostituire un glifo con un modulo alternativo. Spesso, le applicazioni usano questa funzione per impostare un punto puntato o un glifo alternativo all'inizio o alla fine di una riga.

Importante A partire da Windows 8: per mantenere la possibilità di eseguire in Windows 7, un modulo che usa Uniscribe deve specificare Usp10.lib prima di gdi32.lib nell'elenco delle librerie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	usp10.h
Libreria	Usp10.lib
DLL	Usp10.dll
Componente ridistribuibile	Usp10.dll versione 1.600 o successiva in Windows XP