Funzione GetFontData (wingdi.h)
La funzione GetFontData recupera i dati delle metriche dei tipi di carattere per un tipo di carattere TrueType.
Sintassi
DWORD GetFontData(
[in] HDC hdc,
[in] DWORD dwTable,
[in] DWORD dwOffset,
[out] PVOID pvBuffer,
[in] DWORD cjBuffer
);
Parametri
[in] hdc
Handle nel contesto del dispositivo.
[in] dwTable
Nome di una tabella delle metriche del tipo di carattere da cui recuperare i dati del tipo di carattere. Questo parametro può identificare una delle tabelle delle metriche documentate nella specifica TrueType Font Files pubblicata da Microsoft Corporation. Se questo parametro è zero, le informazioni vengono recuperate a partire dall'inizio del file per i file di carattere TrueType o dall'inizio dei dati per i file di raccolta TrueType attualmente selezionati. Per recuperare i dati dall'inizio del file per i file TrueType Collection, specificare "ttcf" (0x66637474).
[in] dwOffset
Offset dall'inizio della tabella delle metriche del tipo di carattere alla posizione in cui la funzione deve iniziare a recuperare informazioni. Se questo parametro è zero, le informazioni vengono recuperate a partire dall'inizio della tabella specificata dal parametro dwTable . Se questo valore è maggiore o uguale alla dimensione della tabella, si verifica un errore.
[out] pvBuffer
Puntatore a un buffer che riceve le informazioni sul tipo di carattere. Se questo parametro è NULL, la funzione restituisce le dimensioni del buffer necessarie per i dati del tipo di carattere.
[in] cjBuffer
Lunghezza, in byte, delle informazioni da recuperare. Se questo parametro è zero, GetFontData restituisce le dimensioni dei dati specificati nel parametro dwTable .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il numero di byte restituiti.
Se la funzione ha esito negativo, il valore restituito è GDI_ERROR.
Commenti
Questa funzione deve essere usata per recuperare le informazioni sul tipo di carattere TrueType direttamente dal file di carattere dalle applicazioni di manipolazione dei tipi di carattere. Per informazioni sull'incorporamento dei tipi di carattere, vedere Riferimento all'incorporamento dei tipi di carattere.
A volte un'applicazione può usare la funzione GetFontData per salvare un tipo di carattere TrueType con un documento. A tale scopo, l'applicazione determina se il tipo di carattere può essere incorporato controllando il membro otmfsType della struttura OUTLINETEXTMETRIC . Se il bit 1 di otmfsType è impostato, l'incorporamento non è consentito per il tipo di carattere. Se bit 1 è chiaro, il tipo di carattere può essere incorporato. Se è impostato bit 2, l'incorporamento è di sola lettura. Se l'incorporamento è consentito, l'applicazione può recuperare l'intero file di carattere, specificando zero per i parametri dwTable, dwOffset e cbData.
Se un'applicazione tenta di usare questa funzione per recuperare informazioni per un tipo di carattere non TrueType, si verifica un errore.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |