Freigeben über


CFont::CreatePointFont

Diese Funktion bietet eine einfache Möglichkeit, eine Schriftart einer angegebenen Schriftarten und des Schriftgrads zu erstellen.

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

Parameter

  • nPointSize
    Angeforderte Schriftarthöhe in den Zehnteln eines Punkts. (beispielsweise, führen Sie 120, eine Schriftart mit 12 Punkten zu aufrufen.)

  • lpszFaceName
    CString oder ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Schriftartnamen der Schriftarten angibt. Die Länge dieser Zeichenfolge darf 30 Zeichen nicht überschreiten. Die Funktion Windows EnumFontFamilies kann verwendet werden, um alle zur Zeit verfügbaren Schriftarten aufzulisten. Wenn lpszFaceNameNULL ist, verwendet das GDI eine geräteunabhängige Schriftart.

  • pDC
    Zeiger auf, um die Höhe verwendet werden CDC-Objekt in nPointSize zu logischen Einheiten zu konvertieren. Wenn NULL, ein Bildschirm-Gerätekontext für die Konvertierung verwendet wird.

Rückgabewert

ungleich 0 (null), wenn erfolgreich; andernfalls 0.

Hinweise

Es konvertiert automatisch die Höhe in nPointSize zu logischen Einheiten mithilfe des CDC-Objekts, das auf durch pDC gezeigt wird.

Wenn Sie mit dem CFont-Objekt beenden, die durch die CreatePointFont-Funktion erstellt wird, wählen Sie zuerst die Schriftart aus dem Gerätekontext out aus, und deaktivieren Sie das CFont-Objekt.

Beispiel

// 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();

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CFont-Klasse

Hierarchiediagramm

CFont::CreatePointFontIndirect

CFont::CreateFont