窗口
from ascript.windows import window
Windows程序窗口检索与操控
方法
查找一个窗口
def find(
active: bool = True,
title: str = None,
name: str = None,
hwnd: int = None) -> Window:
查找一个符合条件的窗口
参数
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
active | bool | 否 | 窗口的是否处于激活状态 默认True |
title | str | 否 | 窗口的标题 |
name | str | 否 | 窗口组件类名 |
hwnd | str | 否 | 窗口句柄,每次窗口重启会变动 |
返回值
参数 | 说明 |
---|---|
Window | 一个窗口对象 |
查找多个窗口
def find_all(
active: bool = None,
title: str = None,
name: str = None) -> [Window]:
参数
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
active | bool | 否 | 窗口的是否处于激活状态 默认False |
title | str | 否 | 窗口的标题 |
name | str | 否 | 窗口组件类名 |
返回值
参数 | 说明 |
---|---|
Window[] | 窗口对象列表 |
是否为活动窗口
def is_active(win:Window)-> bool :
窗口是否处于活动状态
参数
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
返回值
参数 | 说明 |
---|---|
bool | True:处于活动状态,Flase:非活动状态 |
移动或改变窗口宽高
def frame(win:Window, x=None, y=None, w=None, h=None):
参数
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
x | int | 否 | 窗口的位置x |
y | int | 否 | 窗口的位置y |
w | int | 否 | 窗口的宽度 |
w | int | 否 | 窗口的高度 |
返回值
参数 | 说明 |
---|---|
无 |
窗口最小化
def mize_mini(win:Window):
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
返回值
参数 | 说明 |
---|---|
无 |
窗口最大化
def mize_max(win:Window):
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
返回值
参数 | 说明 |
---|---|
无 |
窗口恢复正常大小
def mize_normal(win:Window):
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
返回值
参数 | 说明 |
---|---|
无 |
关闭窗口
def close(win:Window):
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
win | Window | 是 | 窗口对象 |
返回值
参数 | 说明 |
---|---|
无 |
对象
Window
from ascript.windows.window import Window
构造
class Window:
def __init__(self, hwnd: int, fill_children: bool = True):
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
hwnd | int | 是 | 句柄 |
fill_children | bool | 否 | 是否加载子控件 |
属性
属性 | 说明 |
---|---|
hwnd | 窗口句柄 |
title | 窗口的标题 |
name | 窗口组件类名 |
示例
查找活动的窗口
from ascript.windows import window
win = window.find()
# 查找所有
# window_list = Window.find_all(active=True)