Compartilhar via


CFont::FromHandle

Retorna um ponteiro para um objeto de CFont quando usando uma alça de HFONT a um objeto da fonte do windows GDI.

static CFont* PASCAL FromHandle( 
   HFONT hFont  
);

Parâmetros

  • hFont
    Uma alça de HFONT a uma fonte do windows.

Valor de retorno

Um ponteiro para um objeto de CFont se com êxito; se não NULO.

Comentários

Se um objeto de CFont não é anexado já para o identificador, um objeto temporário de CFont é criado e anexado. Este objeto temporário de CFont é válido somente até que a próxima vez que o aplicativo tenha o tempo ocioso em seu loop de evento, quando 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 mensagem da janela.

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 da hierarquia