CTerminalEmulator::SetFont Method  
 
BOOL SetFont(
  HFONT hFont  
);
BOOL SetFont(
  LPTSTR lpszFontName,  
  INT nFontSize  
);

The SetFont sets the font that will be used when updating the display. The specified font must be fixed-width, otherwise the virtual cursor positioning will be incorrect in some cases.

Parameters

hFont
Handle to the font that will be used with the virtual terminal. This parameter may be NULL, in which case a default fixed-width font will be used.
lpszFontName
A pointer to a string which specifies the name of the font that will be loaded. If a NULL pointer or an empty string is passed as the value, the default Terminal font will be used.
nFontSize
The point size of the font that will be loaded. If this value is zero, a default point size will be used.

Return Value

If the method succeeds, the return value is non-zero. If the method fails, it returns zero.

Remarks

If the previous font was a default font created by the library as the result of a NULL font handle being passed to a method, it will be released. However, if the previous font was created by the application, the DeleteObject method must be called to release it.

Requirements

Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
Import Library: csnvtv10.lib

See Also

GetFont