控制台函数用法说明.doc

附录6 控制台函数用法说明 课程设计还应该参考附录4和附录5 附录4 例子程序中用到的dorm.h头文件内容 附录5 编程规范 头文件wincon.h中给出了控制台函数的原型声明及相关类型声明。这里对课程设计中例子程序所用到数据类型和函数的用法进行了说明。 1. 相关数据类型 (1) 字符信息结构类型CHAR_INFO及其结构指针类型PCHAR_INFO typedef struct _CHAR_INFO { union { WCHAR UnicodeChar; CHAR AsciiChar; } Char; WORD Attributes; } CHAR_INFO, *PCHAR_INFO; 包括两个成员。成员Char存放字符的ASCII码值或Unicode码值，成员Attributes存放字符的颜色属性（前景色和背景色）。 成员类型WCHAR是宽字符类型，是unsigned short类型的别名；CHAR是char类型的别名；WORD是unsigned short类型的另一个别名。 (2) 矩形结构类型SMALL_RECT及其结构指针类型PSMALL_RECT typedef struct _SMALL_RECT { SHORT Left; SHORT Top; SHORT Right; SHORT Bottom; } SMALL_RECT, *PSMALL_RECT; 包括四个成员Left、Top、Right和Bottom，分别表示矩形区域左上角和右下角在屏幕上的坐标。 成员类型SHORT是short类型的别名。 (3) 控制台光标信息结构类型CONSOLE_CURSOR_INFO及其结构指针类型PCONSOLE_CURSOR_INFO typedef struct _CONSOLE_CURSOR_INFO { DWORD dwSize; BOOL bVisible; } CONSOLE_CURSOR_INFO,*PCONSOLE_CURSOR_INFO; 包括两个成员dwSize和bVisible。成员dwSize的值表示光标的大小，取值范围为1-100；当为1时，光标最小，仅是一条最靠下的水平细线；当为100时，光标最大，为一个字符大小的方块。成员bVisible表明光标是否可见，取值为TRUE或FALSE。 此结构体中的DWORD是unsigned long类型的别名。 (4) 坐标结构类型COORD及其结构指针类型PCOORD typedef struct _COORD { SHORT X; SHORT Y; } COORD, *PCOORD; 包括两个成员X和Y，分别表示横坐标（列数）和纵坐标（行数）。此结构类型数据除了可表示屏幕上的坐标外，还可用来表示矩形区域的大小，即宽度（X）和高度（Y）。 (5) 控制台屏幕缓冲区信息结构类型CONSOLE_SCREEN_BUFFER_INFO及其结构指针类型PCONSOLE_SCREEN_BUFFER_INFO typedef struct _CONSOLE_SCREEN_BUFFER_INFO { COORD dwSize; COORD dwCursorPosition; WORD wAttributes; SMALL_RECT srWindow; COORD dwMaximumWindowSize; } CONSOLE_SCREEN_BUFFER_INFO,*PCONSOLE_SCREEN_BUFFER_INFO; 成员dwSize表示屏幕区域的大小，即宽度和高度；成员dwCursorPosition表示屏幕中光标的位置；成员wAttributes表示当前字符的颜色属性；srWindow表示当前窗口显示的大小和位置；dwMaximumWindowSize表示最大的窗口缓冲区大小。 (6) 按键事件记录结构类型KEY_EVENT_RECORD typedef struct _KEY_EVENT_RECORD { BOOL bKeyDown; WORD wRepeatCount; WORD wVirtualKeyCode; WORD wVirtualScanCode; union { WCHAR UnicodeChar; CHAR AsciiChar; } uChar; DWORD dwControlKeyState; } KEY_EVENT_RECORD; 6个成员分别表示按键时的相关状态和信息。成员bKeyDown类型为BOOL，取值TRUE表示键按下，FALSE表示键释放；成员wRepeatCount表示按键次数；成员wVirtualKeyCode表示虚拟键代码；成员wVirtualScanCode表