Professional IronPython

Using C# for Win32 Support
 
❘
 
353
requires some additional processing. When a console is in full-screen mode, it can also have access 
to the hardware. This is virtual hardware access, but it still feels to the application as if the access 
is direct. Consequently, the code must now determine whether the console is simply in full-screen 
mode or it’s in full-screen mode with hardware access.
The call could fail, but it’s unlikely to. Even so, the 
GetCurrentDisplayMode()
handles the potential 
problem by providing the 
OutputMode.Unknown
return value. This value simply says that the method 
couldn’t determine the current console display mode.
Defining the GetConsoleWindowSize() Method
Sometimes an application needs to know the maximum windowed console that a machine can 
accommodate. You might need additional room to display complex textual information. The 
Win32 API returns this information in a 
COORD
structure that simply states the number of rows 
and columns of text that a console can support at maximum size. The following code shows the 
GetConsoleWindowSize()
method used to obtain this information.
public COORD GetConsoleWindowSize()
{
// Determine the largest screen size possible.
return GetLargestConsoleWindowSize(hOut);
}
This method is easy. All it does is call the 
GetLargestConsoleWindowSize()
function with
the output handle. Make sure you provide the output handle, and not the input handle, when 
making this call. The 
X
and 
Y
members of 
COORD
contain the maximum screen size on return 
from the call.
If you compare how the 
GetConsoleDisplayMode()
 function works with the 
GetLargestConsoleWindowSize()
 function, you’ll see that they’re inconsistent. 
The inconsistency of the Win32 API calls is one of the reasons that developers 
don’t like to work with them and why using the .NET Framework is better. When 
working with the Win32 API, make sure you know precisely how a function works 
before you use it. Calling some functions using the wrong technique can have ter-
rifying results (such as rebooting your system or damaging data).