CDC::GetFontData
Recupera le informazioni fonte- metriche da un file di caratteri scalabile.
DWORD GetFontData(
DWORD dwTable,
DWORD dwOffset,
LPVOID lpData,
DWORD cbData
) const;
Parametri
dwTable
Specifica il nome della tabella metriche da restituire. Questo parametro può essere una delle tabelle metriche documentate nella specifica di file del tipo di carattere TrueType emessa da Microsoft Corporation. Se questo parametro è 0, le informazioni vengono recuperati iniziare all'inizio del file del tipo.dwOffset
Specifica l'offset dall'inizio della tabella a cui avviare il recupero di informazioni. Se questo parametro è 0, le informazioni vengono avviare recuperato nella parte superiore della tabella specificata dal parametro dwTable. Se questo valore è superiore o uguale alla dimensione della tabella, restituisce 0 GetFontData.lpData
Punta a un buffer che riceverà le informazioni di carattere. Se questo valore è NULL, la funzione restituisce la dimensione del buffer necessario per i dati del tipo specificato nel parametro dwTable.cbData
Specifica la lunghezza, in byte, delle informazioni da recuperare. Se questo parametro è 0, GetFontData restituisce le dimensioni dei dati specificati nel parametro dwTable.
Valore restituito
Specifica il numero di byte restituiti nel buffer puntato da lpData se la funzione ha esito positivo; in caso contrario a 1.
Note
Le informazioni da recuperare sono identificate specificando un offset nel file del tipo e la lunghezza delle informazioni da restituire.
Un'applicazione può talvolta utilizzare la funzione membro GetFontData per salvare un tipo di carattere TrueType a un documento. Per eseguire questa operazione, l'applicazione determina se il tipo può essere compilato e quindi recupera l'intero file di caratteri, specificando 0 per dwTable, dwOffsete i parametri cbData.
Le applicazioni possono determinare se un tipo di carattere può essere incorporata controllando il membro otmfsType della struttura OUTLINETEXTMETRIC. Se a 1 bit otmfsType è impostato, l'incorporamento non è consentito per il tipo. Se a 1 bit è libero, il tipo può essere incorporata. Se a 2 bit è impostato, incorporare è di sola lettura.
Se un'applicazione tenta di utilizzare questa funzione per recuperare le informazioni per un tipo di carattere di non TrueType, la funzione restituisce membro GetFontData a 1.
Requisiti
Header: afxwin.h