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