Terminal.Gui 控制台窗口动态调整方案解析

在开发基于 Terminal.Gui 的终端应用程序时，窗口尺寸的动态调整是一个常见需求。本文将深入探讨如何通过编程方式实现控制台窗口的尺寸调整，并确保 Terminal.Gui 界面能够正确响应这些变化。

问题背景

Terminal.Gui 是一个强大的.NET控制台用户界面框架，但在某些情况下，开发者需要以编程方式调整控制台窗口的尺寸。标准的 Console.SetWindowSize 方法在 Windows Terminal 环境中存在局限性，无法正确触发 Terminal.Gui 的重绘机制。

解决方案原理

通过 Windows API 直接操作控制台窗口是实现可靠尺寸调整的关键。核心思路是：

1. 获取当前控制台窗口的句柄
2. 读取现有窗口尺寸信息
3. 使用底层 API 直接修改窗口尺寸
4. 确保尺寸变化事件能够正确触发 Terminal.Gui 的重绘

实现代码详解

以下是完整的实现方案，基于 Windows API 调用：

// 定义矩形结构体用于存储窗口坐标
struct Rect
{
    public int Left;
    public int Top;
    public int Right;
    public int Bottom;
};

// 获取当前控制台窗口尺寸
private static (int Width, int Height)? GetCurrentConsoleSize()
{
    IntPtr consoleWindowHandle = GetForegroundWindow();
    if (consoleWindowHandle == IntPtr.Zero)
    {
        return null;
    }
    GetWindowRect(consoleWindowHandle, out Rect screenRect);
    return (screenRect.Right - screenRect.Left, screenRect.Bottom - screenRect.Top);
}

// 按像素尺寸调整窗口
private static void ResizeWindowByPixelDimensions(int width, int height)
{
    IntPtr consoleWindowHandle = GetForegroundWindow();
    if (consoleWindowHandle == IntPtr.Zero)
    {
        return;
    }
    GetWindowRect(consoleWindowHandle, out Rect screenRect);
    MoveWindow(consoleWindowHandle, screenRect.Left, screenRect.Top, width, height, true);
}

// 导入所需的Windows API函数
[DllImport("user32.dll")]
static extern IntPtr GetForegroundWindow();
[DllImport("user32.dll")]
static extern bool GetWindowRect(IntPtr hWnd, out Rect lpRect);
[DllImport("user32.dll")]
static extern bool MoveWindow(IntPtr hWnd, int x, int y, int nWidth, int nHeight, bool bRepaint);

技术要点说明

1. 窗口句柄获取：GetForegroundWindow 获取当前活动窗口的句柄，确保我们操作的是正确的控制台窗口。

2. 尺寸读取：GetWindowRect 获取窗口的屏幕坐标，通过计算得到实际宽度和高度。

3. 尺寸调整：MoveWindow 是核心函数，它直接修改窗口的尺寸和位置，最后一个参数控制是否立即重绘窗口。

4. Terminal.Gui 兼容性：这种方法不仅适用于传统控制台，也完全兼容 Windows Terminal，并能正确触发 Terminal.Gui 的重绘机制。

实际应用建议

1. 在应用程序启动时调用此方法初始化窗口尺寸
2. 结合用户配置保存/加载偏好的窗口尺寸
3. 处理窗口尺寸变化事件，动态调整UI布局
4. 考虑添加最小尺寸限制，确保UI元素正常显示

注意事项

1. 此方案仅适用于Windows平台
2. 需要适当处理API调用失败的情况
3. 建议在尺寸变化后短暂延迟，确保系统完成重绘
4. 对于跨平台应用，需要为其他操作系统提供替代实现

通过这种底层API调用方式，开发者可以可靠地控制控制台窗口尺寸，同时确保Terminal.Gui界面能够正确响应这些变化，为用户提供更好的使用体验。