Funzione ScriptGetFontFeatureTags (usp10.h)

Articolo
03/03/2024

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.

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 di 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