Funzione ScriptGetFontFeatureTags (usp10.h)

Recupera un elenco di funzionalità tipografiche per il sistema di scrittura definito per l'elaborazione OpenType. I tag di funzionalità tipografici che comprendono l'elenco vengono recuperati dal tipo di carattere nel contesto di dispositivo o nella cache forniti.

Sintassi

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

Parametri

[in, optional] hdc

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

[in, out] psc

Puntatore a una struttura SCRIPT_CACHE che identifica 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 data shaping, in modo che sia possibile recuperare i tag delle funzionalità dei tipi di carattere per il tipo di carattere e gli script appropriati.

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

[in] tagScript

Struttura OPENTYPE_TAG che definisce il tag di script associato ai tag di funzionalità specificati.

[in] tagLangSys

Struttura OPENTYPE_TAG che definisce il tag di lingua associato ai tag di funzionalità specificati.

[in] cMaxTags

Lunghezza della matrice specificata da pFeatureTags.

[out] pFeatureTags

Puntatore a un buffer in cui questa funzione recupera una matrice di strutture OPENTYPE_TAG che definiscono i tag di funzionalità tipografici supportati dal tipo di carattere nel contesto del dispositivo o nella cache per il sistema di scrittura definito.

[out] pcTags

Puntatore al numero di elementi nella matrice di tag di funzionalità.

Valore restituito

Restituisce 0 in caso di esito positivo. Se non ha esito positivo, la funzione restituisce un valore HRESULT diverso da zero. L'applicazione può testare il valore restituito con le macro SUCCEEDED e FAILED .

Se il numero di tag corrispondenti supera il valore di cMaxTags, la funzione ha esito negativo con E_OUTOFMEMORY. L'applicazione può provare a chiamare di nuovo con buffer di dimensioni maggiori.

Commenti

Sebbene sia formalmente dichiarato come tipo ULONG, una struttura OPENTYPE_TAG contiene una matrice a 4 byte che contiene quattro valori ASCII a 8 bit di spazio, A-Z o a-z. Ad esempio, il tag di funzionalità per la funzionalità legatura è "lega".

Questa funzione nasconde le funzionalità richieste dallo script o dal linguaggio, perché il motore di data shaping controlla queste funzionalità. L'applicazione non ha alcun controllo sulla gestione del motore di shaping per le funzionalità richieste dal linguaggio. Ad esempio , ScriptGetFontFeatureTags nasconde le funzionalità dello script arabo per i moduli iniziali, multimediali e finali.

Requisiti

Vedi anche

Memorizzazione nella cache

OPENTYPE_TAG

SCRIPT_ANALYSIS

SCRIPT_CACHE

ScriptItemizeOpenType

Uniscribe

Funzioni Uniscribe