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

  • The open source cloud computing project OpenStack has come a long way since NASA and Rackspace launched it in 2010. Backed by leading technology infrastructure providers including Cisco, Dell, EMC, HP, IBM, Intel, and VMware, OpenStack underpins significant workloads at an increasingly diverse set of organizations, including BWM, CERN, Comcast, eBay, and Wal-Mart. For CIOs engaged in broader programs to win, serve, and retain customers -- and refocus business technology (BT) spend -- a planned and pragmatic …

  • Today's enterprise datacenter can be one of the most complex business environments with dozens (for smaller business), hundreds (for larger and midsize business), even thousands (for hyperscale businesses) of servers that must be managed and monitored. At this level, just managing the cords can be challenging — let alone keeping up with the growing need for more agility and scalability within the datacenter. Simply put, companies are aggressively looking for less complexity and more agility from their …

Most Popular Programming Stories

More for Developers

RSS Feeds

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