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
一。创建一个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();