Partilhar via


CFont::FromHandle

Retorna um ponteiro para um CFont objeto quando é fornecida uma HFONT o identificador para um objeto de fonte GDI do Windows.

static CFont* PASCAL FromHandle(
   HFONT hFont 
);

Parâmetros

  • hFont
    An HFONT identificador para uma fonte de Windows.

Valor de retorno

Um ponteiro para um CFont objeto se bem-sucedida; caso contrário NULO.

Comentários

If a CFont objeto não está associado já a alça de um temporário CFont o objeto é criado e anexado. Este temporária CFont o objeto é válido apenas até a próxima vez que o aplicativo tenha time de inatividade em loop seu evento, momento em que todos os objetos gráficos temporários são excluídos. Outra maneira de dizer isso é que o objeto temporário é válido somente durante o processamento de uma janela de mensagem.

Exemplo

// The code fragment shows how to create a font object using
// Windows API CreateFontIndirect(), convert the HFONT to a 
// CFont* before selecting the font object into a DC (device 
// context) for text drawing, and finally delete the font object.

// Initialize a CFont object with the characteristics given 
// in a LOGFONT structure.
LOGFONT lf;

// clear out structure
memset(&lf, 0, sizeof(LOGFONT));     
// request a 12-pixel-height font
lf.lfHeight = 12;           
// request a face name "Arial"
_tcsncpy_s(lf.lfFaceName, LF_FACESIZE, _T("Arial"), 7);
// create the font
HFONT hfont = ::CreateFontIndirect(&lf);  

// Convert the HFONT to CFont*.
CFont* pfont = CFont::FromHandle(hfont);

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

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CFont

Gráfico de hierarquia

Outros recursos

CFont membros