### Python 中使用 `uiautomation` 库操作复选框的状态及执行勾选 在 Python 的 UI 自动化中，`uiautomation` 是一个强大的库，用于与 Windows 界面进行交互。以下是关于如何使用该库操作复选框状态的详细说明。 #### 1. 获取复选框的当前状态 通过 `uiautomation` 库中的 `TogglePattern`，可以获取复选框的当前状态。复选框的状态通常有三种： - **On**: 表示复选框被选中。 - **Off**: 表示复选框未被选中。 - **Indeterminate**: 表示复选框处于不确定状态（仅适用于支持三态的复选框）[^1]。 以下是一个代码示例，展示如何获取复选框的状态： ```python import uiautomation as auto # 定位窗口和复选框控件 window = auto.WindowControl(Name="Your Window Title") checkbox = window.CheckBoxControl(Name="Your Checkbox Name") # 获取 TogglePattern 并检查状态 if checkbox.GetTogglePattern().ToggleState == auto.ToggleState.On: print("Checkbox is checked.") elif checkbox.GetTogglePattern().ToggleState == auto.ToggleState.Off: print("Checkbox is unchecked.") elif checkbox.GetTogglePattern().ToggleState == auto.ToggleState.Indeterminate: print("Checkbox is in indeterminate state.") ``` #### 2. 执行勾选或取消勾选 通过调用 `Toggle()` 方法，可以切换复选框的状态。如果需要将复选框设置为特定状态，可以通过多次调用 `Toggle()` 来实现。 以下是一个代码示例，展示如何勾选或取消勾选复选框： ```python import uiautomation as auto # 定位窗口和复选框控件 window = auto.WindowControl(Name="Your Window Title") checkbox = window.CheckBoxControl(Name="Your Checkbox Name") # 检查当前状态并执行相应操作 if checkbox.GetTogglePattern().ToggleState == auto.ToggleState.Off: # 如果复选框未被选中，则执行勾选 checkbox.GetTogglePattern().Toggle() print("Checkbox has been checked.") else: # 如果复选框已被选中，则取消勾选 checkbox.GetTogglePattern().Toggle() print("Checkbox has been unchecked.") ``` #### 3. 设置复选框为特定状态 如果需要明确地将复选框设置为某种状态（例如强制勾选或取消勾选），可以结合当前状态和 `Toggle()` 方法来实现。 以下是一个代码示例，展示如何将复选框设置为已勾选状态： ```python import uiautomation as auto # 定位窗口和复选框控件 window = auto.WindowControl(Name="Your Window Title") checkbox = window.CheckBoxControl(Name="Your Checkbox Name") # 强制将复选框设置为已勾选状态 while checkbox.GetTogglePattern().ToggleState != auto.ToggleState.On: checkbox.GetTogglePattern().Toggle() print("Checkbox is now checked.") ``` #### 注意事项 - 如果目标控件不支持 `TogglePattern`，则调用 `GetTogglePattern()` 方法时会抛出异常[^2]。 - 在某些情况下，复选框可能处于不可交互状态（例如禁用）。在这种情况下，尝试调用 `Toggle()` 方法将不会产生任何效果。 ---