Win32 API 提供了对控制台窗口及其缓冲区相当大的控制权。下图显示了屏幕缓冲区可以大于控制台窗口当前显示的行数。控制台窗口就像是一个“视窗”,显示部分缓冲区。
下列函数影响的是控制台窗口及其相对于屏幕缓冲区的位置:
函数 SetConsoleTitle 可以改变控制台窗口的标题。示例如下:
函数 GetConsoleScreenBufferInfo 返回控制台窗口的当前状态信息。它有两个参数:控制台屏幕的句柄和指向该函数填充的结构的指针:
CONSOLE_SCREEN_BUFFER_INFO 结构如下:
- CONSOLE_SCREEN_BUFFER_INFO STRUCT
- dwSize COORD <>
- dwCursorPosition COORD <>
- wAttributes WORD ?
- srWindow SMALL_RECT <>
- dwMaximumWindowSize COORD <>
- CONSOLE_SCREEN_BUFFER_INFO ENDS
dwSize 按字符行列数返回屏幕缓冲区大小。dwCursorPosition 返回光标的位置。这两个字段都是 COORD 结构。
wAttributes 返回字符的前景色和背景色,字符由诸如 WriteConsole 和 WriteFile 等函数写到控制台。srWindow 返回控制台窗口相对于屏幕缓冲区的坐标。
dwMaximumWindowSize 以当前屏幕缓冲区的大小、字体和视频显示大小为基础,返回控制台窗口的最大尺寸。函数示例调用如下所示:
函数 SetConsoleWindowInfo 可以设置控制台窗口相对于其屏幕缓冲区的大小和位置。函数原型如下:
bAbsolute 说明如何使用结构中由 lpConsoleWindow 指出的坐标。如果 bAbsolute 为真,则坐标定义控制台窗口新的左上角和右下角。如果 bAbsolute 为假,则坐标与当前窗口坐标相加。
下面的程序向屏幕缓冲区写 50 行文本。然后重定义控制台窗口的大小和位置,有效地向后滚动文本。该程序使用了函数 SetConsoleWindowInfo:
- ; 滚动控制台窗口 (Scroll.asm)
- INCLUDE Irvine32.inc
- .data
- message BYTE ": This line of text was written "
- BYTE "to the screen buffer",0dh,0ah
- messageSize DWORD ($-message)
- outHandle HANDLE 0 ; 标准输出句柄
- bytesWritten DWORD ? ; 已写入字节数
- lineNum DWORD 0
- windowRect SMALL_RECT <0,0,60,11> ; 上,下,左,右
- .code
- main PROC
- INVOKE GetStdHandle, STD_OUTPUT_HANDLE
- mov outHandle,eax
- .REPEAT
- mov eax,lineNum
- call WriteDec ; 显示每行编号
- INVOKE WriteConsole,
- outHandle, ; 控制台输出句柄
- ADDR message, ; 字符串指针
- messageSize, ; 字符串长度
- ADDR bytesWritten, ; 返回已写字节数
- 0 ; 未使用
- inc lineNum ; 下一行编号
- .UNTIL lineNum > 50
- ; 调整控制台窗口相对于屏幕缓冲区的大小和位置
- INVOKE SetConsoleWindowInfo,
- outHandle,
- TRUE,
- ADDR windowRect
- call Readchar ; 等待按键
- call Clrscr ; 清除屏幕缓冲区
- call Readchar ; 等待第二次按键
- INVOKE ExitProcess,0
- main ENDP
- END main
最好能直接从 MS-Windows Exlporer 中,或者直接以命令行形式运行程序,而不使用集成的编辑环境。否则,编辑器可能会影响控制台窗口的行为和外观。在程序结束时需要两次按键:第一次清除屏幕缓冲区,第二次结束程序。
函数 SetConsoleScreenBufferSize 可以将屏幕缓冲区设置为 X 列 * Y 行。其原型如下: