PySimpleGUI固定宽高比教程：动态自适应设置方法

理解窗口宽高比的重要性

在图形用户界面（GUI）设计中，保持窗口内容的视觉一致性至关重要。当用户调整窗口大小时，如果内容布局不随之调整，或者以不协调的方式变形，将严重影响用户体验。对于需要显示特定比例图像、视频或复杂布局的应用，固定窗口的宽高比能够确保其内容始终以预期的比例呈现，避免拉伸或压缩。

PySimpleGUI中的宽高比控制原理

PySimpleGUI提供了直接访问和修改窗口尺寸的属性，即 window.Size。要实现宽高比的固定，核心思想是：当窗口尺寸发生变化时，我们获取当前的宽度和高度，计算出当前的宽高比。如果这个宽高比与我们预设的目标宽高比不符，我们就根据目标宽高比和当前窗口的某个维度（例如高度），重新计算另一个维度（例如宽度），然后强制将窗口尺寸设置为新的计算值。

我们通过一个辅助函数 keep_aspect_ratio 来封装这个逻辑。

import PySimpleGUI as sg

def keep_aspect_ratio(window, target_ratio):
    """
    根据目标宽高比调整窗口尺寸。
    如果当前宽高比与目标不符，则根据当前高度重新计算宽度并应用。
    """
    width, height = window.Size
    current_ratio = width / height

    if current_ratio != target_ratio:
        # 如果当前宽高比与目标不符，则根据当前高度重新计算宽度
        new_width = int(height * target_ratio)
        window.Size = (new_width, height)

在 keep_aspect_ratio 函数中：

1. 我们首先获取当前窗口的 width 和 height。
2. 计算当前的 current_ratio。
3. 如果 current_ratio 不等于 target_ratio，说明窗口的宽高比发生了偏差。
4. 为了修正这个偏差，我们选择一个维度（这里是 height）作为基准，然后根据 target_ratio 重新计算 new_width：new_width = int(height * target_ratio)。
5. 最后，通过 window.Size = (new_width, height) 来强制设置窗口的新尺寸。这样，即使用户拖动窗口，PySimpleGUI也会立即将其调整回正确的宽高比。

实现步骤与示例代码

下面是一个完整的PySimpleGUI应用示例，演示如何允许用户输入一个目标宽高比，并在窗口调整大小时自动保持该比例。

import PySimpleGUI as sg

def keep_aspect_ratio(window, target_ratio):
    """
    根据目标宽高比调整窗口尺寸。
    如果当前宽高比与目标不符，则根据当前高度重新计算宽度并应用。
    """
    width, height = window.Size
    current_ratio = width / height

    # 允许一定的浮点数误差
    if abs(current_ratio - target_ratio) > 0.001:
        # 根据当前高度重新计算宽度，以保持目标宽高比
        new_width = int(height * target_ratio)
        window.Size = (new_width, height)

# 定义窗口布局
layout = [
    [sg.Text("输入目标宽高比 (例如 1.777 表示 16:9):")],
    [sg.Input(key="aspect_ratio", default_text="1.777")], # 默认16:9
    [sg.Button("更新宽高比")],
    [sg.Text("拖动窗口边框，观察宽高比自动调整效果。")],
]

# 创建可调整大小的窗口
window = sg.Window("PySimpleGUI 宽高比示例", layout, resizable=True)

# 初始化一个默认的宽高比
current_target_ratio = 1.777 # 默认16:9

while True:
    event, values = window.read(timeout=100) # 使用timeout以便周期性检查

    if event == sg.WINDOW_CLOSED:
        break
    elif event == "Update Aspect Ratio":
        try:
            # 尝试将用户输入转换为浮点数
            new_ratio = float(values["aspect_ratio"])
            if new_ratio <= 0:
                sg.popup_error("宽高比必须是正数。")
            else:
                current_target_ratio = new_ratio
                # 立即应用新的宽高比
                keep_aspect_ratio(window, current_target_ratio)
        except ValueError:
            sg.popup_error("请输入一个有效的数字作为宽高比。")

    # 无论是否有事件发生，都周期性地检查并调整宽高比
    # 这确保了即使是用户拖动窗口，也能实时调整
    keep_aspect_ratio(window, current_target_ratio)

window.close()

在上述代码中：

1. UI布局：包含一个文本提示、一个输入框用于用户输入目标宽高比，以及一个按钮用于确认更新。
2. 窗口创建：sg.Window("PySimpleGUI 宽高比示例", layout, resizable=True) 创建一个可调整大小的窗口。resizable=True 是实现动态调整的前提。
3. 事件循环：
   • window.read(timeout=100)：设置一个 timeout 参数，使得 read() 方法即使在没有用户交互时也会每100毫秒返回一次。这允许我们在没有特定事件发生时（例如用户正在拖动窗口）也能周期性地调用 keep_aspect_ratio 函数，从而实现实时的宽高比修正。
   • 当用户点击“更新宽高比”按钮时，我们尝试解析输入框中的值。如果输入有效，则更新 current_target_ratio。
   • 最关键的是，在事件循环的每次迭代中，我们都调用 keep_aspect_ratio(window, current_target_ratio)。这意味着无论用户是否在拖动窗口，或者是否有其他事件发生，窗口的宽高比都会被周期性地检查和修正，从而实现“固定”的效果。

注意事项与最佳实践

1. 避免使用底层API：原始问题中尝试使用 win32gui.MoveWindow 等Windows API来控制窗口尺寸。对于PySimpleGUI应用，强烈建议使用PySimpleGUI自身提供的 window.Size 属性进行尺寸控制。PySimpleGUI已经封装了底层的窗口操作，直接使用其API更简洁、更稳定，且跨平台兼容性更好。
2. 实时调整的性能考量：通过 timeout 周期性调用 keep_aspect_ratio 可以实现实时调整。对于大多数应用而言，100ms或更短的超时时间足以提供流畅的用户体验。如果窗口内容非常复杂，频繁的尺寸调整可能会略微影响性能，但对于PySimpleGUI的典型用例，这通常不是问题。
3. 浮点数比较：在 keep_aspect_ratio 函数中，比较 current_ratio 和 target_ratio 时，我们使用了 abs(current_ratio - target_ratio) > 0.001 而不是 current_ratio != target_ratio。这是因为浮点数运算可能存在微小的精度误差，直接比较可能导致不必要的调整。设置一个小的容忍度（例如0.001）可以避免这种问题。
4. 初始窗口尺寸：在创建窗口时，可以根据一个初始的宽高比来设置 size 参数，确保窗口在启动时就符合预期的比例。
5. 用户输入验证：对用户输入的宽高比进行严格的验证，确保其是有效的正数，避免程序因无效输入而崩溃。

总结

通过利用PySimpleGUI的 window.Size 属性和在事件循环中周期性地调用一个简单的宽高比修正函数，我们可以有效地在PySimpleGUI应用中实现窗口宽高比的动态固定。这种方法简洁、高效，并能显著提升用户界面的专业性和用户体验。它避免了直接操作底层操作系统API的复杂性和潜在问题，使得开发者能够专注于应用逻辑本身。