CFont::CreatePointFont

發行項
02/28/2013

這個函式會提供簡單的方式來建立指定的字樣的字型和字型大小。

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

參數

nPointSize
所要求之字型高度 (以點為單位的秒。 (例如，傳遞 120 要求 12 點) 的字型。
lpszFaceName
一 CString 或指標設定為指定的字型字樣名稱的 NULL 結尾字串。這個字串的長度不能超過 30 個字元。視窗 EnumFontFamilies 函式可用於列舉目前所有可用的字型。如果是， lpszFaceNameNULLGDI 使用與裝置無關的字樣。
pDC
要使用的 CDC 物件的指標轉換在 nPointSize 的高度設定為邏輯單位。如果 NULL，螢幕裝置內容的轉換。

傳回值

不是零，如果成功，則為 0。

備註

使用 pDC，指到 CDC 物件會自動轉換。 nPointSize 的高度設定為邏輯單位。

當您完成使用 CreatePointFont 函式時所建立的 CFont 物件，請先選取字型在裝置內容之外，然後刪除 CFont 物件。

範例

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