CConsole: A wrapper for Console APIs

This class is a wrapper for Console APIs. While browsing through the newsgroups, I realized that there are many developers who use console to output their diagnostic messages and to take input from the user in order to change the behavior during debug. So, Here it is. This class encompasses of one really important function RedirectToConsole () whose code is I got from Mr.Andrew Tucker's article in WDJ Dec 97 and also from a KB article (Q126628). Along with that I have added some more functions to make life easier.

Following is the list of functions available.

//Constructor & Destructor

(); //This creates an empty class. This will not create the console.

CConsole (BOOL); // This creates the class and a console if TRUE is passed as an argument.

~CConsole (); //destroys the class and the console if created.


short GetNumberOfLines();

short SetNumberOfLines (short sLines);

These functions set/get the number of lines you want in the console. SetNumberOfLines () returns the old value.

short GetNumberOfColumns ();

short SetNumberOfColumns (short sColumns);

These functions set/get the number of columns you want in the console. SetNumberOfColumns () returns the old value.

WORD GetAttributes ();

WORD SetAttributes (WORD wAttrib,short NumChars = 0);

These functions set/get the attributes you want in the console. SetAttributes () returns the old value. If you set the NumChars to other value than 0, It will set the attributes only to that many characters. Otherwise, It will be set from the cursor position to end of the console. The values that can be used is given below.

short SetMaxLinesInWindow (short maxLines);

short GetMaxLinesInWindow();

Get/Sets the maximum lines in the window..


void RedirectToConsole (WORD wFlags);

Redirect the console io functions to console, i.e. printf(), scanf(), cout(), cin() etc. wFlags is not used (yet).J

BOOL SetupConsole(WORD wFlags);

Sets up the console to given flag. Internal function..

HANDLE GetHandle (DWORD dwFlag);

This returns the specified handle STD_OUTPUT_HANDLE, STD_INPUT_HANDLE and STD_ERROR_HANDLE are the valid dwFlag values.

BOOL Clear ();

Clears the screen with the specified attributes. Used a KB article to get it working.

WORD GetSettings (WORD wFlags);

Get the settings for a given flag.

BOOL CreateConsole ();

Creates the console.

BOOL DestroyConsole ();

Destroys the console.


//Attribute Values




//Flags to be used in SetupConsole and GetSettings


NOTE: If you are using it in MFC application with precompiled headers, you need to #include "stdafx.h" in the beginning of Console.cpp. Otherwise, you might see a error C1010 while compiling.

Download file. It contains a small test.cpp which shows how to use this class. Add the files to a win32 application's project and compile. That should run without complaining.

Have Fun..


  • How can I Change the color of Console window?

    Posted by Legacy on 10/10/2000 12:00am

    Originally posted by: Sneha

    How can I Change the color of Console window? If you know, Please mail me. It's a urgent.

  • App terminates if console window is closed by user using the system menu.

    Posted by Legacy on 12/23/1998 12:00am

    Originally posted by: Roy Kiesler

    How can I prevent my app from terminating in this situation?


  • Programmer

    Posted by Legacy on 09/28/1998 12:00am

    Originally posted by: Max Leung

    This is an excellent solution for adding proper console support to MFC applications. A simple call to ::AllocConsole() and then using this class works beautifully, and you don't need to convert your application into a console application either!

    Thanks very much!

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Enterprises are increasingly looking to platform as a service (PaaS) to lower their costs and speed their time to market for new applications. Developing, deploying, and managing applications in the cloud eliminates the time and expense of managing a physical infrastructure to support them. PaaS offerings must deliver additional long-term benefits, such as a lower total cost of ownership (TCO), rapid scalability, and ease of integration, all while providing robust security and availability. This report …

  • Anthony Christie, the Chief Marketing Officer for Level Communications, is responsible for customer experience, worldwide marketing and product management. In this informative asset, he shares his insights into why a private network connection to cloud-bases applications is the right decision for your enterprise. Download now to find out more.

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date