理解窗口宽高比需求
在开发图形用户界面（gui）应用程序时，保持窗口内容的视觉一致性至关重要。当用户调整窗口大小时，如果内容不按比例缩放，可能会导致布局混乱、元素重叠或显示不完整。pysimplegui提供了resizable=true参数允许用户自由调整窗口大小，但这同时也带来了如何维持特定宽高比的挑战。
固定窗口宽高比的需求通常源于以下几点：
- 视觉一致性：确保UI元素在任何尺寸下都保持其预期的相对位置和大小。
- 布局稳定性：防止因非比例缩放导致的布局破坏，特别是对于图像、视频播放器或特定图表显示区域。
- 用户体验：提供更可预测和专业的应用程序外观。
PySimpleGUI本身并没有内置的直接固定宽高比的参数。因此，我们需要通过编程方式，在窗口尺寸发生变化时（或在用户明确指令后），主动计算并强制执行所需的宽高比。
PySimpleGUI实现固定宽高比的核心原理
实现窗口固定宽高比的核心在于：
- 获取窗口当前的宽度和高度。
- 计算当前的宽高比。
- 与目标宽高比进行比较。
- 如果当前宽高比与目标不符，则根据其中一个维度（通常是用户输入或程序预设的固定维度）计算另一个维度所需的新值。
- 使用window.Size属性来更新窗口的尺寸。
以下是实现这一功能的关键函数keep_aspect_ratio：
import PySimpleGUI as sg
def keep_aspect_ratio(window, target_ratio):
"""
根据目标宽高比调整窗口尺寸。
此函数会保持当前高度不变，调整宽度以匹配目标比例。
如果需要根据宽度调整高度，请修改内部计算逻辑。
Args:
window (sg.Window): PySimpleGUI窗口对象。
target_ratio (float): 目标宽高比（宽度/高度）。
"""
width, height = window.Size
current_ratio = width / height
# 如果当前比例与目标比例不符，则进行调整
if current_ratio != target_ratio:
# 根据当前高度和目标比例，计算新的宽度
# 例如：如果目标比例是16:9 (16/9)，当前高度是500，则新宽度 = 500 * (16/9)
new_width = int(height * target_ratio)
# 更新窗口尺寸。这里保持高度不变，调整宽度。
# 如果需要根据宽度调整高度，则计算 new_height = int(width / target_ratio)
# 并设置 window.Size = (width, new_height)
window.Size = (new_width, height)在这个keep_aspect_ratio函数中，我们首先获取窗口的当前width和height。然后，计算出current_ratio。如果current_ratio与target_ratio不一致，我们根据当前的height和target_ratio计算出新的new_width，最后通过window.Size = (new_width, height)来强制设置窗口的新尺寸。
完整示例代码解析
下面是一个完整的PySimpleGUI应用程序，演示了如何集成上述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)
# 定义窗口布局
layout = [
[sg.Text("请输入目标宽高比 (例如 1.77 for 16:9):")],
[sg.Input(key="aspect_ratio", default_text="1.77")], # 默认16:9
[sg.Button("应用宽高比")],
[sg.Text("调整窗口大小后，点击“应用宽高比”按钮查看效果")],
]
# 创建窗口，并设置为可调整大小
window = sg.Window("PySimpleGUI 宽高比示例", layout, resizable=True)
# 事件循环
while True:
event, values = window.read()
if event == sg.WINDOW_CLOSED:
break
elif event == "应用宽高比":
try:
target_ratio = float(values["aspect_ratio"])
# 调用函数来调整窗口尺寸
keep_aspect_ratio(window, target_ratio)
except ValueError:
sg.popup_error("请输入一个有效的数字作为宽高比！")
window.close()代码解析：
- 导入PySimpleGUI: import PySimpleGUI as sg 是所有PySimpleGUI应用的基础。
- keep_aspect_ratio函数: 如前所述，该函数负责计算并调整窗口尺寸以符合目标宽高比。
-
布局定义:
- sg.Text用于显示提示信息。
- sg.Input(key="aspect_ratio", default_text="1.77") 允许用户输入期望的宽高比，并提供了一个默认值（1.77，即16:9）。key参数用于在values字典中获取输入内容。
- sg.Button("应用宽高比") 是触发宽高比调整操作的按钮。
- 窗口创建: sg.Window("PySimpleGUI 宽高比示例", layout, resizable=True) 创建了应用程序窗口。resizable=True参数是允许用户手动拖拽调整窗口大小的关键。
-
事件循环:
- while True: 循环持续监听用户事件。
- event, values = window.read() 读取下一个事件和当前所有输入元素的值。
- if event == sg.WINDOW_CLOSED: 检查用户是否关闭了窗口。
- elif event == "应用宽高比": 当用户点击“应用宽高比”按钮时，此分支被执行。
- try-except块用于处理用户输入无效数字的情况，确保程序的健壮性。
- target_ratio = float(values["aspect_ratio"]) 将用户输入的字符串转换为浮点数。
- keep_aspect_ratio(window, target_ratio) 调用核心函数来执行尺寸调整。
- 关闭窗口: window.close() 在事件循环结束后关闭窗口，释放资源。
注意事项
- 实时调整与按需调整: 上述示例是在用户点击“应用宽高比”按钮后才进行调整。如果需要实现用户拖拽窗口边缘时实时固定宽高比，则需要更复杂的机制，例如通过window.read(timeout=...)设置一个短的超时时间，在每次超时时检查window.Size是否变化并进行调整。然而，频繁的尺寸调整可能会导致视觉上的闪烁或性能问题，因此按需调整通常是更稳健的选择。
- 调整基准: keep_aspect_ratio函数当前是基于保持高度不变，调整宽度。如果你的需求是保持宽度不变，调整高度，只需将函数内部的计算逻辑修改为new_height = int(width / target_ratio)，然后设置window.Size = (width, new_height)。
- 边框和标题栏: 在某些操作系统上，窗口的实际可绘制区域（客户端区域）会比window.Size报告的尺寸小，因为window.Size可能包含了窗口的边框和标题栏。对于PySimpleGUI，window.Size通常直接对应于内容区域的尺寸，但在极少数情况下，如果遇到微小的偏差，可能需要考虑这些额外的像素。本示例中的方法在PySimpleGUI中通常能很好地工作。
- 错误处理: 确保对用户输入进行验证，避免因无效输入（如非数字字符）导致程序崩溃。示例中已包含try-except ValueError来处理此情况。
总结
通过PySimpleGUI提供的window.Size属性，我们可以灵活地控制窗口的尺寸。结合一个简单的计算函数，就能有效地实现窗口的固定宽高比功能，从而提升应用程序的专业性和用户体验。这种方法不仅适用于简单的宽高比固定，也可以扩展到更复杂的布局管理场景中。
