CFont::CreatePointFont

Articolo
03/05/2013

Questa funzione consente di creare in modo semplice un tipo di carattere di un carattere tipografico e una dimensione in punti specifici.

BOOL CreatePointFont(
   int nPointSize,
   LPCTSTR lpszFaceName,
   CDC* pDC = NULL 
);

Parametri

nPointSize
Altezza del carattere richiesta nei decimi di un punto.Ad esempio, passare 120 per richiedere un tipo di carattere di 12 punti.)
lpszFaceName
CString o un puntatore a una stringa con terminazione null che specifica il nome del carattere tipografico di carattere.La lunghezza della stringa non deve superare 30 caratteri.La funzione di Windows EnumFontFamilies può essere utilizzata per enumerare tutti i tipi di carattere attualmente disponibili.Se lpszFaceName è NULL, GDI utilizza un carattere tipografico indipendente dal dispositivo.
pDC
Puntatore all'oggetto CDC da utilizzare per convertire l'altezza in nPointSize alle unità logiche.Se NULL, un contesto di dispositivo dello schermo viene utilizzato per la conversione.

Valore restituito

Diverso da zero se l'operazione viene completata correttamente, altrimenti 0.

Note

Converte automaticamente l'altezza in nPointSize alle unità logiche utilizzando l'oggetto CDC puntato da pDC.

Dopo aver utilizzato l'oggetto CFont creato dalla funzione CreatePointFont, innanzitutto selezionare il tipo di carattere dal contesto di dispositivo, quindi eliminare l'oggetto CFont.

Esempio

// The code fragment shows how to create a font object,
// select the font object into a DC (device context) for text
// drawing, and finally delete the font object.

CClientDC dc(this);

CFont font;
VERIFY(font.CreatePointFont(120, _T("Arial"), &dc));

// Do something with the font just created...
CFont* def_font = dc.SelectObject(&font);
dc.TextOut(5, 5, _T("Hello"), 5);
dc.SelectObject(def_font);

// Done with the font. Delete the font object.
font.DeleteObject();