Funzione ScriptSubstituteSingleGlyph (usp10.h)

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.

Requisiti

Vedi anche

Memorizzazione nella cache

OPENTYPE_TAG

SCRIPT_ANALYSIS

SCRIPT_CACHE

ScriptGetFontAlternateGlyphs

ScriptItemizeOpenType

Uniscribe

Funzioni uniscrivere