CTerminalEmulator::Reset Method  
 
BOOL Reset(
  HWND hWnd,  
  HFONT hFont,  
  UINT nColumns,  
  UINT nRows  
);
BOOL Reset(
  UINT nColumns,  
  UINT nRows  
);

The Reset resets the virtual terminal display, using the new window, font, columns and rows. This method should be used when the virtual display must be attached to a different window, or the number of rows or columns must be changed.

Parameters

hWnd
Handle to the window that will be used to display the virtual terminal. This parameter may be NULL, in which case the current window will be used.
hFont
Handle to the font that will be used with the virtual terminal. This parameter may be NULL, in which case the current font will be used. If a font is specified, it must be fixed-width, otherwise the virtual cursor positioning will be incorrect in some cases.
nColumns
The maximum number of columns used by the virtual display. A value of zero specifies that the same number of columns should be used. If a non-zero value is specified, it must be at least 5, and no greater than 255.
nRows
The maximum number of rows used by the virtual display. A value of zero specifies that the same number of columns should be used. If a non-zero value is specified, it must be at least 5, and no greater than 127.

Return Value

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

Remarks

This method will clear the display and reset the current text attributes.

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

Clear, Create, Refresh, Resize, Update