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

Vedi anche

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

GetTextMetrics

OUTLINETEXTMETRIC