|
|
| HDISPLAY
NvtCreateDisplay(
|
|
|
HWND hWnd, |
|
|
|
|
HFONT hFont, |
|
|
|
|
UINT
nEmulation, |
|
|
|
|
UINT nColumns, |
|
|
|
|
UINT nRows |
|
|
| );
|
The NvtCreateDisplay function creates a new virtual
terminal emulation display using the specified window and font.
Parameters
- hWnd
- Handle to the window that will be used to display the virtual
terminal.
- 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. If a font is specified, it must be fixed-width,
otherwise the virtual cursor positioning will be incorrect in some
cases.
- nEmulation
- Identifies the virtual terminal emulation type. The following
emulation types are currently supported.
| Constant |
Description |
|
NVT_EMULATION_NONE |
The virtual display does not emulate any
specific terminal type, and does not process escape sequences. |
|
NVT_EMULATION_ANSI |
The virtual display processes ANSI escape
sequences for screen management and cursor positioning. This
emulation also supports escape sequences to control the foreground
and background color. The default keymap for ANSI function key
escape sequences will be selected. |
|
NVT_EMULATION_VT100 |
The virtual display processes DEC VT-100 escape
sequences for screen management and cursor positioning. The default
keymap for a DEC VT-100 terminal will be selected. |
|
NVT_EMULATION_VT220 |
The virtual display processes DEC VT-220 escape
sequences for screen management and cursor positioning. This
emulation also supports DEC VT-320 escape sequences to control the
foreground and background color. The default keymap for a DEC
VT-220 terminal will be selected. |
- nColumns
- The maximum number of columns used by the virtual display. This
value must be at least 5, and no greater than 255.
- nRows
- The maximum number of rows used by the virtual display. This
value must be at least 5, and no greater than 127.
Return Value
If the function succeeds, the return value is a handle to the
virtual display. If the function fails, the return value is
INVALID_DISPLAY.
Remarks
The default colors for the display is a black background and
white foreground. If ANSI terminal emulation is selected, bold
characters will be displayed on a white background and blue
foreground.
Requirements
Client: Requires Windows Vista, Windows XP or Windows
2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or
Windows 2000 Server.
Header: Include cstools6.h.
Library: Use csnvtav6.lib.
See Also
NvtDestroyDisplay, NvtInitialize, NvtUninitialize
|
|