SetConsoleWindowInfo 函数--设置控制台窗口的大小和位置

时间:2021-08-25 23:44:45

SetConsoleWindowInfo函数

来源:https://msdn.microsoft.com/en-us/library/windows/desktop/ms686125(v=vs.85).aspx

作用

设置当前窗口在控制台屏幕缓冲区的位置和大小

语法

BOOL WINAPI SetConsoleWindowInfo(
    _In_       HANDLE     hConsoleOutput,
    _In_       BOOL       bAbsolute,
    _In_ const SMALL_RECT *lpConsoleWindow
);


参数

hConsoleOutput
  控制台屏幕缓冲区的句柄。
bAbsolute
  该参数一般为TRUE。
lpConsoleWindow
  指向 SMALL_RECT 结构体的指针,指定窗口在屏幕缓冲区的左上角和右下角位置。

注意:窗口坐标的X轴水平向右,Y轴竖直向下。Left和Top指定窗口左上角位置(显示的第一个字符位置);Right和Bottom指定窗口右下角位置(显示的最后一个字符位置)。如果只是想改变窗口大小,将Left和Top设置为0,Right和Bottom设置为 宽度值-1 和 高度值-1 即可。

返回值

如果函数操作成功,返回值为非零值。
如果函数操作失败,返回值为零。

头文件

Wincon.h(包括Windows.h)

示例

#include <iostream>
#include <Windows.h>
int main()
{
    using namespace std;
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    SMALL_RECT rc;
    rc.Left = 5;
    rc.Top = 5;
    rc.Right = 54;
    rc.Bottom = 24;
    //此时窗口的宽度为50,高度为20
    SetConsoleWindowInfo(hOut, TRUE, &rc);
    for (int i = 0; i < 10; ++i)
        cout << "**********" << i << endl; 
    cout << "0123456789" << endl;
    cin.get();
    CloseHandle(hOut);    
    return 0;
}

在没有使用SetConsoleWindowInfo函数之前,程序的输出如下:
SetConsoleWindowInfo 函数--设置控制台窗口的大小和位置

使用后:
SetConsoleWindowInfo 函数--设置控制台窗口的大小和位置

假定以图1的窗口为屏幕缓冲区的大小,那么实际指定的显示区域为:
SetConsoleWindowInfo 函数--设置控制台窗口的大小和位置