控制台屏幕缓冲区

MFC调用win32窗口显示调试信息，使用AllocConsole 函数(2010-11-16 15:33:25)转载标签： 调试win32mfc杂谈 分类： 编译器 AllocConsole Function 为主调进程分配一个新的控制台。 语法 C++ ： BOOL WINAPI AllocConsole(void); 参数： 无 返回值：如果函数成功，返回值是非零值；如果函数失败，返回值是零值。 备注： 一个进程仅能关联一个控制台，所以该函数在主调进程已经具有控制台时将会失败。 一个进程可以使用 FreeConsole 函数来释放与之关联的控制台，之后它就可以调用该函数来创建一个新的控制台或使用 AttachConsole 函数来关联另一个控制台。 如果主调进程创建了一个子进程，则子进程也将继承这个新创建的控制台。 该函数为新的控制台初始化标准输入、输出、错误句柄等。 标准输入句柄是一个控制台输入缓冲的句柄，标准输出和标准错误句柄则是控制台屏幕缓冲的句柄。为了获得这些句柄，可以使用 GetStdHandle 函数。 该函数主要用于GUI应用程序来创建一个控制台窗口。 GUI应用程序初始化时时没有控制台的，而控制台应用程序则以控制台来初始化的。 要求 ： Minimum supported client Windows 2000 Professional Minimum supported server Windows 2000 Server Header： Wincon.h (include Windows.h) Library： Kernel32.lib DLL Kernel32.dll ---------------------------------------------------------------------------------------- 虽然WIN32时代是图形界面时代，但偶尔程序中还需要用到命令行模式，比如批处理，这时再搞个图形界面出来显得似乎就不那么专业了。但客户还需要在正常状态下（对于命令行模式，我认为用户是非正常状态，比如脑子进水。）使用图形界面，这决定我们不能开一个控制台工程，而需要使用MFC exe程序。 OK，理所当然的，通过条件控制，命令行下我关掉对话框界面的调用代码，再使用 cout << "Hello world!" << endl; 来向这个友好的世界打个招呼，并坚持认为这句问候应该显示在CMD那个漆黑的窗口里。 很沮丧地说，事实给我与痛击。cmd窗口里仍然漆黑一片，系统完全不理会我的友好。 邓爷爷说，改革开放好！也许，我也需要个改革。 在同事mr. zhang的指导下，我找到一组API：Console Functions！正是这组API，最终让我的友好得以正当地表达。 一。创建一个Console，AllocConsole 直接使用 AllocConsole(); 马上，若是进程内第一次调用这个函数，一个空的cmd窗口会蹦出来。需要注意，一个进程只能创建一个console，多次调用会返回FALSE；而且，这个窗口是个独立的控制台窗口。 MSDN的解释：A process can be associated with only one console, so the AllocConsole function fails if the calling process already has a console. 还有段：If the calling process creates a child process, the child inherits the new console. 二。显示Hello World，WriteConsole 有了console，我们还需要获取它的句柄HANDLE，然后才能在上面显示。方法是 GetStdHandle，它会获取前面我们AllocConsole得到的cmd窗口的句柄；若未调用AllocConsole，将获取标准的输入输出窗口句柄。 MSDN的解释：The GetStdHandle function returns a handle for the standard input, standard output, or standard error device. HANDLE hdlWrite = GetStdHandle(STD_OUTPUT_HANDLE); //这里也可以使用STD_ERROR_HANDLE TCHAR c[] = {"Hello world!"}; WriteConsole(hdlWrite, c, sizeof(c), NULL, NULL); 得到Console的句柄后直接使用 WriteConsole 函数即可在屏幕上显示啦。这个函数有5个参数：第一个是console的句柄，第二个是写出内容的地址，第三个参数是预计写出长度，第四个参数是实际写出长度，可为NULL，但不建议，若使用NULL，boundchecker会在这提示错误用法，第五参数系统保留，必须使用NULL。 MSDN里说也可以使用WriteFile来向console的handle输出。 三。获取用户输入， ReadConsole 光显示是不够的，用户还需要操作啊，当然，是键盘输入。 前面我们已经创建了一个Console，输入也需要使用这个console，但若还用上面的OUTPUT句柄就不行了，我们会发现，程序在下面这句会直接跳过。 ReadConsole(hdlWrite, c, 2, NULL, NULL); 这里，我们还需要一个STD_INPUT_HANDLE；如下： TCHAR Buffer[100]; //开缓存 memset(Buffer, 0, 100); DWORD dwCount = 0;//已输入数 HANDLE hdlRead = GetStdHandle(STD_INPUT_HANDLE); ReadConsole(hdlRead, Buffer, 100, &dwCount;, NULL); 这个函数和WriteConsole类似，但需要注意的是，第四个参数必须指定，否则会无法读取。 MSDN里还提到，若需要获取其它键盘外的输入信息，如鼠标信息，只能使用ReadConsoleInput函数： If the input buffer contains input events other than keyboard events (such as mouse events or window-resizing events), they are discarded. Those events can only be read by using the ReadConsoleInput function. 四。关闭Console 最后用完记得使用CloseHandle释放句柄，如： CloseHandle(hdlRead); CloseHandle(hdlWrite); 若想关闭Console，可以使用FreeConsole(); 需要注意的是，若用户直接点击cmd窗口的关闭按钮，整个程序(Application)将退出！ 五。其他函数 这组函数还提供了其他有趣的功能，比如修改console的背景色，前景色等。更多函数请参见MSDN。 AllocConsole(); SetConsoleTitle("Lonefox love China"); //修改Console的标题 HANDLE hConsole = CreateConsoleScreenBuffer( GENERIC_READ | GENERIC_WRITE, //权限 FILE_SHARE_READ | FILE_SHARE_WRITE, //console的共享方式 NULL,//安全性设置，NULL默认即可 CONSOLE_TEXTMODE_BUFFER,//唯一值 NULL//保留 );//创建console的屏幕内容缓存,一个进程可以有多个ScreenBuffer SetConsoleActiveScreenBuffer(hConsole); //显示该buffer的内容 SetConsoleTextAttribute(hConsole, FOREGROUND_RED | BACKGROUND_GREEN); TCHAR c[] = {"Hello world!\n"}; WriteConsole(hConsole, c, sizeof(c), NULL, NULL); //在屏幕显示 CloseHandle(hConsole); FreeConsole(); 后记：本文仅学习笔记，非教科书。若有问题欢迎留言讨论！