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();

 posted on 2011-08-05 11:57  berryz2007  阅读(629)  评论(0编辑  收藏  举报