Pywinauto-0.6.8 controls.common_controls 控件模块 电脑端软件GUI鼠标键盘Python自动化办公、测试、重复性工作制定库

• pywinauto.controls.common_controls 官方文档

Windows 公共控件的类

common_controls._toolbar_button

class pywinauto.controls.common_controls._toolbar_button(index_, tb_handle)

Bases: object

工具栏按钮 （TBBUTTONINFO） 项

_toolbar_button.click

pywinauto.controls.common_controls._toolbar_button.click(button='left', pressed='')

• 单击“工具栏”按钮

_toolbar_button.click_input

pywinauto.controls.common_controls._toolbar_button.click_input(button='left', double=False, wheel_dist=0, pressed='')

• 单击“工具栏”按钮

_toolbar_button.has_style

pywinauto.controls.common_controls._toolbar_button.has_style(style)

• 如果按钮具有指定的样式，则返回 True

_toolbar_button.is_checkable

pywinauto.controls.common_controls._toolbar_button.is_checkable()

• 如果可以选中按钮，则返回

_toolbar_button.is_checked

pywinauto.controls.common_controls._toolbar_button.is_checked()

• 如果按钮处于选中状态，则返回

_toolbar_button.is_enabled

pywinauto.controls.common_controls._toolbar_button.is_enabled()

• 如果按钮处于按下状态，则返回

_toolbar_button.is_pressable

pywinauto.controls.common_controls._toolbar_button.is_pressable()

• 如果可以按下按钮，则返回

_toolbar_button.is_pressed

pywinauto.controls.common_controls._toolbar_button.is_pressed()

• 如果按钮处于按下状态，则返回

_toolbar_button.rectangle

pywinauto.controls.common_controls._toolbar_button.rectangle()

• 获取工具栏上按钮的矩形

_toolbar_button.state

pywinauto.controls.common_controls._toolbar_button.state()

• 返回按钮的状态

_toolbar_button.style

pywinauto.controls.common_controls._toolbar_button.style()

• 返回按钮的样式

_toolbar_button.text

pywinauto.controls.common_controls._toolbar_button.text()

• 返回按钮的文本

common_controls._treeview_element

class pywinauto.controls.common_controls._treeview_element(elem, tv_handle)

Bases: object

TreeView 项的包装

_treeview_element.children

pywinauto.controls.common_controls._treeview_element.children()

• 返回此控件的直接子项

_treeview_element.click

pywinauto.controls.common_controls._treeview_element.click(button='left', double=False, where='text', pressed='')

• 单击 treeview 项

单击对象可以是“text”、“icon”、“button”、“check”中的任何一个。默认为“text”

_treeview_element.click_input

pywinauto.controls.common_controls._treeview_element.click_input(button='left', double=False, wheel_dist=0, where='text', pressed='')

• 单击 treeview 项

单击对象可以是“text”、“icon”、“button”、“check”中的任何一个。默认为“text”。

_treeview_element.client_rect

pywinauto.controls.common_controls._treeview_element.client_rect(text_area_rect=True)

• 返回 treeview 文本区域的矩形

如果 text_area_rect 设置为 False，将返回整个项目的矩形（通常 left 等于 0）。默认值为 True - 仅返回项文本的矩形。

_treeview_element.collapse

pywinauto.controls.common_controls._treeview_element.collapse()

• 折叠此 treeview 的子项

_treeview_element.drop

pywinauto.controls.common_controls._treeview_element.drop(button='left', pressed='')

• 在 treeview 中执行鼠标左键的拖放操作。

_treeview_element.ensure_visible

pywinauto.controls.common_controls._treeview_element.ensure_visible()

• 确保 TreeView 项可见

_treeview_element.expand

pywinauto.controls.common_controls._treeview_element.expand()

• 展开此 TreeView 的子项

_treeview_element.get_child

pywinauto.controls.common_controls._treeview_element.get_child(child_spec, exact=False)

返回此 TreeView 的子项目

接受字符串或索引。如果传递了字符串，则返回与该字符串最匹配的子项。

_treeview_element.is_checked

pywinauto.controls.common_controls._treeview_element.is_checked()

• 是否选中 TreeView 项；是返回 True，否则 False 。

_treeview_element.is_expanded

pywinauto.controls.common_controls._treeview_element.is_expanded()

• 指示是否选中了 TreeView 项

_treeview_element.is_selected

pywinauto.controls.common_controls._treeview_element.is_selected()

• 指示是否选中了 TreeView 项

_treeview_element.item

pywinauto.controls.common_controls._treeview_element.item()

• 返回 TreeView 中的项目本身。

_treeview_element.next_item

pywinauto.controls.common_controls._treeview_element.next_item()

• 返回下一项

_treeview_element.select

pywinauto.controls.common_controls._treeview_element.select()

• 选择“TreeView”项

_treeview_element.start_dragging

pywinauto.controls.common_controls._treeview_element.start_dragging(button='left', pressed='')

• 启动拖拽操作

_treeview_element.state

pywinauto.controls.common_controls._treeview_element.state()

• 返回项目的状态

_treeview_element.sub_elements

pywinauto.controls.common_controls._treeview_element.sub_elements()

返回此控件的子项列表

_treeview_element.text

pywinauto.controls.common_controls._treeview_element.text()

返回项目的文本

common_controls._listview_item

class pywinauto.controls.common_controls._listview_item(lv_ctrl, item_index, subitem_index=0)

Bases: object

• ListView 项的封装

_listview_item.check

pywinauto.controls.common_controls._listview_item.check()

• 选中 ListView 项

_listview_item.click

pywinauto.controls.common_controls._listview_item.click(button='left', double=False, where='text', pressed='')

• 单击 ListView

单击对象可以是“all”、“icon”、“text”、“select”、“check”中的任何一个，默认为“text”

_listview_item.click_input

pywinauto.controls.common_controls._listview_item.click_input(button='left', double=False, wheel_dist=0, where='text', pressed='')

• 单击 ListView

单击对象可以是“all”、“icon”、“text”、“select”、“check”中的任何一个，默认为“text”

_listview_item.deselect

pywinauto.controls.common_controls._listview_item.deselect()

• 将项目标记为未选中

必须先启用 ListView 控件并使其可见，然后才能选择 Item，否则会引发异常。

_listview_item.ensure_visible

pywinauto.controls.common_controls._listview_item.ensure_visible()

• 确保 ListView 项可见

_listview_item.image

pywinauto.controls.common_controls._listview_item.image()

• 返回项目的图像索引

_listview_item.indent

pywinauto.controls.common_controls._listview_item.indent()

• 返回项目的缩进

_listview_item.inplace_control

pywinauto.controls.common_controls._listview_item.inplace_control(friendly_class_name='')

• 返回项目的编辑器 HwndWrapper

friendly_class_name 值：

• "" 返回第一个出现的就地控件
• "friendlyclassname" 返回具有特定 friendlyclassname 的编辑器

_listview_item.is_checked

pywinauto.controls.common_controls._listview_item.is_checked()

• 返回是否选中 ListView 项

_listview_item.is_focused

pywinauto.controls.common_controls._listview_item.is_focused()

• 如果项目具有焦点，则返回 True

_listview_item.is_selected

pywinauto.controls.common_controls._listview_item.is_selected()

• 如果选中了项目，则返回 True

_listview_item.item

pywinauto.controls.common_controls._listview_item.item()

• 返回项目本身（LVITEM 实例）

_listview_item.item_data

pywinauto.controls.common_controls._listview_item.item_data()

• 返回项目数据（字典）

_listview_item.rectangle

pywinauto.controls.common_controls._listview_item.rectangle(area='all')

• 返回项的矩形。

area 参数	说明
all	返回整个项的边界矩形，包括图标和标签。
icon	返回图标或小图标的边界矩形。
text	返回项文本的边界矩形。
select	返回“图标”和“文本”矩形的并集，但排除报表视图中的列。

_listview_item.select

pywinauto.controls.common_controls._listview_item.select()

• 将项目标记为已选中

必须先启用 ListView 控件并使其可见，然后才能选择 Item，否则会引发异常

_listview_item.state

pywinauto.controls.common_controls._listview_item.state()

• 返回项目的状态

_listview_item.text

pywinauto.controls.common_controls._listview_item.text()

• 返回项目的文本

_listview_item.uncheck

pywinauto.controls.common_controls._listview_item.uncheck()

• 取消选中 ListView 项

common_controls.AnimationWrapper

class pywinauto.controls.common_controls.AnimationWrapper(element_info)

Windows 动画公共控件的类

common_controls.CalendarWrapper

class pywinauto.controls.common_controls.CalendarWrapper(hwnd)

Windows 日历公共控件的类

CalendarWrapper.calc_min_rectangle

pywinauto.controls.common_controls.CalendarWrapper.calc_min_rectangle(left, top, right, bottom)

• 计算矩形需要的最小大小才能容纳该数量的日历

CalendarWrapper.count

pywinauto.controls.common_controls.CalendarWrapper.count()

• 获取日历计数

CalendarWrapper.get_border

pywinauto.controls.common_controls.CalendarWrapper.get_border()

• 获取日历边框

CalendarWrapper.get_current_date

pywinauto.controls.common_controls.CalendarWrapper.get_current_date()

• 获取当前选定的日期

CalendarWrapper.get_first_weekday

pywinauto.controls.common_controls.CalendarWrapper.get_first_weekday()

• Get 不在当前区域设置中，如果是这样，则为一周的第一天

CalendarWrapper.get_id

pywinauto.controls.common_controls.CalendarWrapper.get_id()

• 获取日历类型

CalendarWrapper.get_month_delta

pywinauto.controls.common_controls.CalendarWrapper.get_month_delta()

• 检索月日历控件的滚动速率

CalendarWrapper.get_month_range

pywinauto.controls.common_controls.CalendarWrapper.get_month_range(scope_of_range)

• 检索表示月份日历控件显示的上限和下限的日期信息。

CalendarWrapper.get_today

pywinauto.controls.common_controls.CalendarWrapper.get_today()

• 获取今天日期

CalendarWrapper.get_view

pywinauto.controls.common_controls.CalendarWrapper.get_view()

• 获取日历视图

CalendarWrapper.hit_test

pywinauto.controls.common_controls.CalendarWrapper.hit_test(x, y)

• 确定月日历控件的哪个部分位于屏幕上的给定点

CalendarWrapper.set_border

pywinauto.controls.common_controls.CalendarWrapper.set_border(border)

• 设置日历边框

CalendarWrapper.set_color

pywinauto.controls.common_controls.CalendarWrapper.set_color(place_of_color, red, green, blue)

• 在您指定的日历的某个位置设置一些颜色。

接收四个参数： - 第一个参数可能采用以下几个变体：‘background’、‘month_background’、‘text’、‘title_background’、‘title_text’、‘trailing_text’;- 所有其他参数应为 0 到 255 之间的整数。

CalendarWrapper.set_current_date

pywinauto.controls.common_controls.CalendarWrapper.set_current_date(year, month, day_of_week, day)

• 设置当前选定的日期

CalendarWrapper.set_day_states

pywinauto.controls.common_controls.CalendarWrapper.set_day_states(month_states)

• 设置当前可见的所有月份的日期状态

CalendarWrapper.set_first_weekday

pywinauto.controls.common_controls.CalendarWrapper.set_first_weekday(dayNum)

• 设置一周的第一天

CalendarWrapper.set_id

pywinauto.controls.common_controls.CalendarWrapper.set_id(ID)

• 设置日历类型。

仅接收一个参数，该参数采用以下变体：‘gregorian’、‘gregorian_us’、‘japan’、‘taiwan’、‘korea’、‘hijri’、‘thai’、‘hebrew’、‘gregorian_me_french’、‘gregorian_arabic’、‘gregorian_english_xlit’、‘gregorian_french_xlit’、‘umalqura’

CalendarWrapper.set_month_delta

pywinauto.controls.common_controls.CalendarWrapper.set_month_delta(delta)

• 设置月日历控件的滚动速率。

CalendarWrapper.set_today

pywinauto.controls.common_controls.CalendarWrapper.set_today(year, month, day)

• 设定今天日期

CalendarWrapper.set_view

pywinauto.controls.common_controls.CalendarWrapper.set_view(viewType)

• 设置日历视图

common_controls.ComboBoxExWrapper

class pywinauto.controls.common_controls.ComboBoxExWrapper(element_info)

Windows ComboBoxEx 公共控件的类

common_controls.DateTimePickerWrapper

class pywinauto.controls.common_controls.DateTimePickerWrapper(element_info)

Windows DateTimePicker 公共控件的类

DateTimePickerWrapper.GetTime

pywinauto.controls.common_controls.DateTimePickerWrapper.GetTime(*args, **kwargs)

DateTimePickerWrapper.SetTime

pywinauto.controls.common_controls.DateTimePickerWrapper.SetTime(*args, **kwargs)

DateTimePickerWrapper.get_time

pywinauto.controls.common_controls.DateTimePickerWrapper.get_time()

• 获取当前选定的时间

DateTimePickerWrapper.set_time

pywinauto.controls.common_controls.DateTimePickerWrapper.set_time(year=0, month=0, day_of_week=0, day=0, hour=0, minute=0, second=0, milliseconds=0)

• 设置当前选定的时间

common_controls.HeaderWrapper

class pywinauto.controls.common_controls.HeaderWrapper(hwnd)

Windows ListView 标头公共控件的类

HeaderWrapper.GetColumnRectangle

pywinauto.controls.common_controls.HeaderWrapper.GetColumnRectangle(*args, **kwargs)

HeaderWrapper.GetColumnText

pywinauto.controls.common_controls.HeaderWrapper.GetColumnText(*args, **kwargs)

HeaderWrapper.ItemCount

pywinauto.controls.common_controls.HeaderWrapper.ItemCount(*args, **kwargs)

HeaderWrapper.client_rects

pywinauto.controls.common_controls.HeaderWrapper.client_rects()

• 返回标头控件的所有客户端矩形

HeaderWrapper.get_column_rectangle

pywinauto.controls.common_controls.HeaderWrapper.get_column_rectangle(column_index)

• 返回 column_index 指定的列的矩形

HeaderWrapper.get_column_text

pywinauto.controls.common_controls.HeaderWrapper.get_column_text(column_index)

• 返回 column_index 指定的列的文本

HeaderWrapper.item_count

pywinauto.controls.common_controls.HeaderWrapper.item_count()

• 返回此标头中的列数

HeaderWrapper.texts

pywinauto.controls.common_controls.HeaderWrapper.texts()

• 返回 Header 控件的文本

common_controls.HotkeyWrapper

class pywinauto.controls.common_controls.HotkeyWrapper(element_info)

Windows 热键公共控件的类

common_controls.IPAddressWrapper

class pywinauto.controls.common_controls.IPAddressWrapper(element_info)

Windows IPAddress 公共控件的类

common_controls.ListViewWrapper

class pywinauto.controls.common_controls.ListViewWrapper(hwnd)

Windows ListView 公共控件的类

这个派生类自 HwndWrapper - 该类的所有方法也是如此

参阅 hwndwrapper.HwndWrapper

ListViewWrapper.Check

pywinauto.controls.common_controls.ListViewWrapper.Check(*args, **kwargs)

ListViewWrapper.ColumnCount

pywinauto.controls.common_controls.ListViewWrapper.ColumnCount(*args, **kwargs)

ListViewWrapper.ColumnWidths

pywinauto.controls.common_controls.ListViewWrapper.ColumnWidths(*args, **kwargs)

ListViewWrapper.Columns

pywinauto.controls.common_controls.ListViewWrapper.Columns(*args, **kwargs)

ListViewWrapper.Deselect

pywinauto.controls.common_controls.ListViewWrapper.Deselect(*args, **kwargs)

ListViewWrapper.GetColumn

pywinauto.controls.common_controls.ListViewWrapper.GetColumn(*args, **kwargs)

ListViewWrapper.GetHeaderControl

pywinauto.controls.common_controls.ListViewWrapper.GetHeaderControl(*args, **kwargs)

ListViewWrapper.GetItem

pywinauto.controls.common_controls.ListViewWrapper.GetItem(*args, **kwargs)

ListViewWrapper.GetItemRect

pywinauto.controls.common_controls.ListViewWrapper.GetItemRect(*args, **kwargs)

ListViewWrapper.GetSelectedCount

pywinauto.controls.common_controls.ListViewWrapper.GetSelectedCount(*args, **kwargs)

ListViewWrapper.IsFocused

pywinauto.controls.common_controls.ListViewWrapper.IsFocused(*args, **kwargs)

ListViewWrapper.IsSelected

pywinauto.controls.common_controls.ListViewWrapper.IsSelected(*args, **kwargs)

ListViewWrapper.Item

pywinauto.controls.common_controls.ListViewWrapper.Item(*args, **kwargs)

ListViewWrapper.ItemCount

pywinauto.controls.common_controls.ListViewWrapper.ItemCount(*args, **kwargs)

ListViewWrapper.Items

pywinauto.controls.common_controls.ListViewWrapper.Items(*args, **kwargs)

ListViewWrapper.Select

pywinauto.controls.common_controls.ListViewWrapper.Select(*args, **kwargs)

ListViewWrapper.UnCheck

pywinauto.controls.common_controls.ListViewWrapper.UnCheck(*args, **kwargs)

ListViewWrapper.check

pywinauto.controls.common_controls.ListViewWrapper.check(item)

• 选中 ListView 项

ListViewWrapper.column_count

pywinauto.controls.common_controls.ListViewWrapper.column_count()

• 返回列数

ListViewWrapper.column_widths

pywinauto.controls.common_controls.ListViewWrapper.column_widths()

• 返回所有列宽的列表

pywinauto.controls.common_controls.ListViewWrapper.columns()

• 获取有关 ListView 列的信息

ListViewWrapper.deselect

pywinauto.controls.common_controls.ListViewWrapper.deselect(item)

• 将项目标记为未选中

必须先启用 ListView 控件并使其可见，然后才能选择 Item，否则会引发异常

ListViewWrapper.get_column

pywinauto.controls.common_controls.ListViewWrapper.get_column(col_index)

• 获取 ListView 列的信息

ListViewWrapper.get_header_control

pywinauto.controls.common_controls.ListViewWrapper.get_header_control()

• 返回与 ListView 关联的 Header 控件

ListViewWrapper.get_item

pywinauto.controls.common_controls.ListViewWrapper.get_item(item_index, subitem_index=0)

• 返回列表视图的项目”

• item_index
  可以是项的索引，也可以是包含要返回的项文本的字符串。
• subitem_index
  要返回的项目的从零开始的索引。默认值为 0。

ListViewWrapper.get_item_rect

pywinauto.controls.common_controls.ListViewWrapper.get_item_rect(item_index)

• 返回列表视图项的边界矩形

ListViewWrapper.get_selected_count

pywinauto.controls.common_controls.ListViewWrapper.get_selected_count()

• 返回所选项目的数量

ListViewWrapper.is_checked

pywinauto.controls.common_controls.ListViewWrapper.is_checked(item)

• 返回是否选中 ListView 项

ListViewWrapper.is_focused

pywinauto.controls.common_controls.ListViewWrapper.is_focused(item)

• 如果项目具有焦点，则返回 True

ListViewWrapper.is_selected

pywinauto.controls.common_controls.ListViewWrapper.is_selected(item)

• 如果选中了项目，则返回 True

ListViewWrapper.item

pywinauto.controls.common_controls.ListViewWrapper.item(item_index, subitem_index=0)

• 返回列表视图的项目”

• item_index
  可以是项的索引，也可以是包含要返回的项文本的字符串。
• subitem_index
  要返回的项目的从零开始的索引。默认值为 0。

ListViewWrapper.item_count

pywinauto.controls.common_controls.ListViewWrapper.item_count()

• ListView 中的项数

ListViewWrapper.items

pywinauto.controls.common_controls.ListViewWrapper.items()

• 获取列表视图中的所有项目

ListViewWrapper.select

pywinauto.controls.common_controls.ListViewWrapper.select(item)

将项目标记为已选中

必须先启用 ListView 控件并使其可见，然后才能选择 Item，否则会引发异常

ListViewWrapper.texts

pywinauto.controls.common_controls.ListViewWrapper.texts()

• 获取 ListView 控件的文本

ListViewWrapper.uncheck

pywinauto.controls.common_controls.ListViewWrapper.uncheck(item)

取消选中 ListView 项

ListViewWrapper.writable_props

pywinauto.controls.common_controls.ListViewWrapper.writable_props

• 扩展默认属性列表。

common_controls.PagerWrapper

class pywinauto.controls.common_controls.PagerWrapper(element_info)

Windows Pager 公共控件的类

PagerWrapper.GetPosition

pywinauto.controls.common_controls.PagerWrapper.GetPosition(*args, **kwargs)

PagerWrapper.SetPosition

pywinauto.controls.common_controls.PagerWrapper.SetPosition(*args, **kwargs)

PagerWrapper.get_position

pywinauto.controls.common_controls.PagerWrapper.get_position()

• 获取滚动条（Pager）当前的位置。

PagerWrapper.set_position

pywinauto.controls.common_controls.PagerWrapper.set_position(pos)

• 设置滚动条（Pager）的当前位置为指定位置（pos）。

common_controls.ProgressWrapper

class pywinauto.controls.common_controls.ProgressWrapper(element_info)

Windows 进度公共控件的类

ProgressWrapper.GetPosition

pywinauto.controls.common_controls.ProgressWrapper.GetPosition(*args, **kwargs)

ProgressWrapper.GetState

pywinauto.controls.common_controls.ProgressWrapper.GetState(*args, **kwargs)

ProgressWrapper.GetStep

pywinauto.controls.common_controls.ProgressWrapper.GetStep(*args, **kwargs)

ProgressWrapper.SetPosition

pywinauto.controls.common_controls.ProgressWrapper.SetPosition(*args, **kwargs)

ProgressWrapper.StepIt

pywinauto.controls.common_controls.ProgressWrapper.StepIt(*args, **kwargs)

ProgressWrapper.get_position

pywinauto.controls.common_controls.ProgressWrapper.get_position()

• 获取进度条（ProgressBar）当前的位置

ProgressWrapper.get_state

pywinauto.controls.common_controls.ProgressWrapper.get_state()

• 获取进度条（ProgressBar）的状态。

State 将是以下常量之一：

• PBST_NORMAL
• PBST_ERROR
• PBST_PAUSED

ProgressWrapper.get_step

pywinauto.controls.common_controls.ProgressWrapper.get_step()

• 获取进度条（ProgressBar）的步长大小。

ProgressWrapper.set_position

pywinauto.controls.common_controls.ProgressWrapper.set_position(pos)

• 设置进度条（ProgressBar）的当前位置为指定位置（pos）。

ProgressWrapper.step_it

pywinauto.controls.common_controls.ProgressWrapper.step_it()

• 将进度条向前移动一步

common_controls.ReBarWrapper

class pywinauto.controls.common_controls.ReBarWrapper(hwnd)

Windows ReBar 公共控件的类

ReBarWrapper.BandCount

pywinauto.controls.common_controls.ReBarWrapper.BandCount(*args, **kwargs)

ReBarWrapper.GetBand

pywinauto.controls.common_controls.ReBarWrapper.GetBand(*args, **kwargs)

ReBarWrapper.GetToolTipsControl

pywinauto.controls.common_controls.ReBarWrapper.GetToolTipsControl(*args, **kwargs)

ReBarWrapper.band_count

pywinauto.controls.common_controls.ReBarWrapper.band_count()

• 返回控件中的波段（bands）数量。

ReBarWrapper.get_band

pywinauto.controls.common_controls.ReBarWrapper.get_band(band_index)

• 获取 ReBar 控件中的一个波段（band）

ReBarWrapper.get_tool_tips_control

pywinauto.controls.common_controls.ReBarWrapper.get_tool_tips_control()

• 返回与此控件关联的工具提示（tooltip）控件

ReBarWrapper.texts

pywinauto.controls.common_controls.ReBarWrapper.texts()

• 返回 ReBar（重复栏控件）中的文本内容

ReBarWrapper.writable_props

pywinauto.controls.common_controls.ReBarWrapper.writable_props

• 扩展默认属性列表，允许对 ReBar 控件的一些属性进行写操作

common_controls.StatusBarWrapper

class pywinauto.controls.common_controls.StatusBarWrapper(hwnd)

Windows 状态栏公共控件的类

StatusBarWrapper.BorderWidths

pywinauto.controls.common_controls.StatusBarWrapper.BorderWidths(*args, **kwargs)

StatusBarWrapper.GetPartRect

pywinauto.controls.common_controls.StatusBarWrapper.GetPartRect(*args, **kwargs)

StatusBarWrapper.GetPartText

pywinauto.controls.common_controls.StatusBarWrapper.GetPartText(*args, **kwargs)

StatusBarWrapper.PartCount

pywinauto.controls.common_controls.StatusBarWrapper.PartCount(*args, **kwargs)

StatusBarWrapper.PartRightEdges

pywinauto.controls.common_controls.StatusBarWrapper.PartRightEdges(*args, **kwargs)

StatusBarWrapper.border_widths

pywinauto.controls.common_controls.StatusBarWrapper.border_widths()

• 返回状态栏（StatusBar）的边框宽度

返回一个字典，其中包含状态栏（StatusBar）的三种可用宽度：水平宽度（Horizontal）- 水平方向的宽度，垂直宽度（Vertical）- 状态栏部分上下的宽度，以及交叉宽度（Inter）- 状态栏部分之间的宽度。

StatusBarWrapper.client_rects

pywinauto.controls.common_controls.StatusBarWrapper.client_rects()

• 返回控件的客户端矩形

StatusBarWrapper.get_part_rect

pywinauto.controls.common_controls.StatusBarWrapper.get_part_rect(part_index)

• 返回 part_index 指定的零件的矩形

StatusBarWrapper.get_part_text

pywinauto.controls.common_controls.StatusBarWrapper.get_part_text(part_index)

• 返回 part_index 指定的部件的文本

StatusBarWrapper.part_count

pywinauto.controls.common_controls.StatusBarWrapper.part_count()

• 返回部件数

StatusBarWrapper.part_right_edges

pywinauto.controls.common_controls.StatusBarWrapper.part_right_edges()

• 返回零件的宽度

StatusBarWrapper.texts

pywinauto.controls.common_controls.StatusBarWrapper.texts()

• 返回控件的文本

common_controls.TabControlWrapper

class pywinauto.controls.common_controls.TabControlWrapper(hwnd)

Windows 选项卡公共控件的类

TabControlWrapper.GetSelectedTab

pywinauto.controls.common_controls.TabControlWrapper.GetSelectedTab(*args, **kwargs)

TabControlWrapper.GetTabRect

pywinauto.controls.common_controls.TabControlWrapper.GetTabRect(*args, **kwargs)

TabControlWrapper.GetTabText

pywinauto.controls.common_controls.TabControlWrapper.GetTabText(*args, **kwargs)

TabControlWrapper.RowCount

pywinauto.controls.common_controls.TabControlWrapper.RowCount(*args, **kwargs)

TabControlWrapper.Select

pywinauto.controls.common_controls.TabControlWrapper.Select(*args, **kwargs)

TabControlWrapper.TabCount

pywinauto.controls.common_controls.TabControlWrapper.TabCount(*args, **kwargs)

TabControlWrapper.client_rects

pywinauto.controls.common_controls.TabControlWrapper.client_rects()

• 返回选项卡控件（TabControl）的客户端矩形（client rectangles）

TabControlWrapper.get_properties

pywinauto.controls.common_controls.TabControlWrapper.get_properties()

• 以字典形式返回选项卡控件（TabControl）的属性

TabControlWrapper.get_selected_tab

pywinauto.controls.common_controls.TabControlWrapper.get_selected_tab()

• 返回选项卡控件（TabControl）中当前选中选项卡的索引

TabControlWrapper.get_tab_rect

pywinauto.controls.common_controls.TabControlWrapper.get_tab_rect(tab_index)

• 返回指定索引（tab_index）的选项卡在选项卡控件（TabControl）中的矩形区域

TabControlWrapper.get_tab_text

pywinauto.controls.common_controls.TabControlWrapper.get_tab_text(tab_index)

• 返回指定索引（tab_index）的选项卡的文本内容。

TabControlWrapper.row_count

pywinauto.controls.common_controls.TabControlWrapper.row_count()

• 返回选项卡控件（TabControl）中选项卡的行数

TabControlWrapper.select

pywinauto.controls.common_controls.TabControlWrapper.select(tab)

• 在选项卡控件（TabControl）上选择指定的选项卡（tab）

TabControlWrapper.tab_count

pywinauto.controls.common_controls.TabControlWrapper.tab_count()

• 返回选项卡控件（TabControl）中选项卡的数量

TabControlWrapper.texts

pywinauto.controls.common_controls.TabControlWrapper.texts()

• 返回选项卡控件（TabControl）中所有选项卡的文本内容

TabControlWrapper.writable_props

pywinauto.controls.common_controls.TabControlWrapper.writable_props

• 扩展默认属性列表，允许对选项卡控件（TabControl）的一些属性进行写操作。

common_controls.ToolTip

class pywinauto.controls.common_controls.ToolTip(ctrl, tip_index)

Bases: object

工具提示（ToolTip）控件的单个提示信息。需要两个参数：控件对象（ctrl）和提示索引（tip_index）

common_controls.ToolTipsWrapper

class pywinauto.controls.common_controls.ToolTipsWrapper(hwnd)

Windows 工具提示（Tooltips）常用控件，但是尚未完全实现。它需要一个参数：窗口句柄（hwnd）

ToolTipsWrapper.GetTip

pywinauto.controls.common_controls.ToolTipsWrapper.GetTip(*args, **kwargs)

ToolTipsWrapper.GetTipText

pywinauto.controls.common_controls.ToolTipsWrapper.GetTipText(*args, **kwargs)

ToolTipsWrapper.ToolCount

pywinauto.controls.common_controls.ToolTipsWrapper.ToolCount(*args, **kwargs)

ToolTipsWrapper.get_tip

pywinauto.controls.common_controls.ToolTipsWrapper.get_tip(tip_index)

• 返回特定索引（tip_index）的工具提示（Tooltip）

ToolTipsWrapper.get_tip_text

pywinauto.controls.common_controls.ToolTipsWrapper.get_tip_text(tip_index)

• 返回工具提示（Tooltip）的文本内容，通过指定的索引（tip_index）

ToolTipsWrapper.texts

pywinauto.controls.common_controls.ToolTipsWrapper.texts()

• 返回所有工具提示（Tooltip）的文本内容

ToolTipsWrapper.tool_count

pywinauto.controls.common_controls.ToolTipsWrapper.tool_count()

• 返回工具提示（Tooltip）的数量

common_controls.ToolbarWrapper

class pywinauto.controls.common_controls.ToolbarWrapper(hwnd)

Windows 工具栏公共控件的类

ToolbarWrapper.Button

pywinauto.controls.common_controls.ToolbarWrapper.Button(*args, **kwargs)

ToolbarWrapper.ButtonCount

pywinauto.controls.common_controls.ToolbarWrapper.ButtonCount(*args, **kwargs)

ToolbarWrapper.CheckButton

pywinauto.controls.common_controls.ToolbarWrapper.CheckButton(*args, **kwargs)

ToolbarWrapper.GetButton

pywinauto.controls.common_controls.ToolbarWrapper.GetButton(*args, **kwargs)

ToolbarWrapper.GetButtonRect

pywinauto.controls.common_controls.ToolbarWrapper.GetButtonRect(*args, **kwargs)

ToolbarWrapper.GetButtonStruct

pywinauto.controls.common_controls.ToolbarWrapper.GetButtonStruct(*args, **kwargs)

ToolbarWrapper.GetToolTipsControl

pywinauto.controls.common_controls.ToolbarWrapper.GetToolTipsControl(*args, **kwargs)

ToolbarWrapper.MenuBarClickInput

pywinauto.controls.common_controls.ToolbarWrapper.MenuBarClickInput(*args, **kwargs)

ToolbarWrapper.PressButton

pywinauto.controls.common_controls.ToolbarWrapper.PressButton(*args, **kwargs)

ToolbarWrapper.TipTexts

pywinauto.controls.common_controls.ToolbarWrapper.TipTexts(*args, **kwargs)

ToolbarWrapper.button

pywinauto.controls.common_controls.ToolbarWrapper.button(button_identifier, exact=True, by_tooltip=False)

• 返回指定索引（button_index）处的按钮

ToolbarWrapper.button_count

pywinauto.controls.common_controls.ToolbarWrapper.button_count()

• 返回工具栏（ToolBar）上的按钮数量

ToolbarWrapper.check_button

pywinauto.controls.common_controls.ToolbarWrapper.check_button(button_identifier, make_checked, exact=True)

• 查找按钮的位置，如果按钮未被选中则点击它，反之亦然。

ToolbarWrapper.get_button

pywinauto.controls.common_controls.ToolbarWrapper.get_button(button_index)

• 返回工具栏（ToolBar）按钮的信息，通过指定的索引（button_index）

ToolbarWrapper.get_button_rect

pywinauto.controls.common_controls.ToolbarWrapper.get_button_rect(button_index)

• 获取工具栏（ToolBar）上指定索引（button_index）按钮的矩形区域

ToolbarWrapper.get_button_struct

pywinauto.controls.common_controls.ToolbarWrapper.get_button_struct(button_index)

• 返回工具栏（ToolBar）按钮的 TBBUTTON 结构，通过指定的索引（button_index）

ToolbarWrapper.get_tool_tips_control

pywinauto.controls.common_controls.ToolbarWrapper.get_tool_tips_control()

• 返回与此控件关联的工具提示（tooltip）控件

pywinauto.controls.common_controls.ToolbarWrapper.menu_bar_click_input(path, app)

• 通过路径选择菜单栏项目（实验性功能！）

路径由以“->”分隔的项目列表指定，每个项目可以是要返回的项目的零基索引，以 # 开头，例如 #1。例：

“#1 -> #0”, “#1->#0->#0”

ToolbarWrapper.press_button

pywinauto.controls.common_controls.ToolbarWrapper.press_button(button_identifier, exact=True)

• 查找按钮的位置并点击它

ToolbarWrapper.texts

pywinauto.controls.common_controls.ToolbarWrapper.texts()

• 返回工具栏（ToolBar）的文本内容

ToolbarWrapper.tip_texts

pywinauto.controls.common_controls.ToolbarWrapper.tip_texts()

• 返回工具栏（ToolBar）的提示文本内容（不包括窗口文本）

ToolbarWrapper.writable_props

pywinauto.controls.common_controls.ToolbarWrapper.writable_props

• 扩展默认属性列表

common_controls.TrackbarWrapper

class pywinauto.controls.common_controls.TrackbarWrapper(element_info)

Windows Trackbar 公共控件的类

TrackbarWrapper.get_channel_rect

pywinauto.controls.common_controls.TrackbarWrapper.get_channel_rect()

• 获取 Trackbar 的边界矩形的位置

TrackbarWrapper.get_line_size

pywinauto.controls.common_controls.TrackbarWrapper.get_line_size()

• 获取跟踪栏滑块的逻辑位置数

TrackbarWrapper.get_num_ticks

pywinauto.controls.common_controls.TrackbarWrapper.get_num_ticks()

• 获取跟踪栏数量刻度

TrackbarWrapper.get_page_size

pywinauto.controls.common_controls.TrackbarWrapper.get_page_size()

• 获取跟踪栏滑块的逻辑位置数

TrackbarWrapper.get_position

pywinauto.controls.common_controls.TrackbarWrapper.get_position()

• 获取跟踪栏位置

TrackbarWrapper.get_range_max

pywinauto.controls.common_controls.TrackbarWrapper.get_range_max()

• 获取最大可用跟踪栏值

TrackbarWrapper.get_range_min

pywinauto.controls.common_controls.TrackbarWrapper.get_range_min()

• 获取最小可用跟踪栏值

TrackbarWrapper.get_sel_end

pywinauto.controls.common_controls.TrackbarWrapper.get_sel_end()

• 获取选择结束

TrackbarWrapper.get_sel_start

pywinauto.controls.common_controls.TrackbarWrapper.get_sel_start()

• 开始选择

TrackbarWrapper.get_tooltips_control

pywinauto.controls.common_controls.TrackbarWrapper.get_tooltips_control()

• 获取跟踪栏工具提示框

TrackbarWrapper.set_line_size

pywinauto.controls.common_controls.TrackbarWrapper.set_line_size(line_size)

• 设置跟踪栏线大小

TrackbarWrapper.set_page_size

pywinauto.controls.common_controls.TrackbarWrapper.set_page_size(page_size)

• 设置跟踪栏页面大小

TrackbarWrapper.set_position

pywinauto.controls.common_controls.TrackbarWrapper.set_position(pos)

• 设置跟踪栏位置

TrackbarWrapper.set_range_max

pywinauto.controls.common_controls.TrackbarWrapper.set_range_max(range_max)

• 设置最大可用跟踪栏值

TrackbarWrapper.set_range_min

pywinauto.controls.common_controls.TrackbarWrapper.set_range_min(range_min)

• 设置最小可用跟踪栏值

TrackbarWrapper.set_sel

pywinauto.controls.common_controls.TrackbarWrapper.set_sel(sel_start, sel_end)

• 设置选择的开始和结束

common_controls.TreeViewWrapper

class pywinauto.controls.common_controls.TreeViewWrapper(hwnd)

Windows TreeView 公共控件的类

TreeViewWrapper.EnsureVisible

pywinauto.controls.common_controls.TreeViewWrapper.EnsureVisible(*args, **kwargs)

TreeViewWrapper.GetItem

pywinauto.controls.common_controls.TreeViewWrapper.GetItem(*args, **kwargs)

TreeViewWrapper.IsSelected

pywinauto.controls.common_controls.TreeViewWrapper.IsSelected(*args, **kwargs)

TreeViewWrapper.Item

pywinauto.controls.common_controls.TreeViewWrapper.Item(*args, **kwargs)

TreeViewWrapper.ItemCount

pywinauto.controls.common_controls.TreeViewWrapper.ItemCount(*args, **kwargs)

TreeViewWrapper.PrintItems

pywinauto.controls.common_controls.TreeViewWrapper.PrintItems(*args, **kwargs)

TreeViewWrapper.Root

pywinauto.controls.common_controls.TreeViewWrapper.Root(*args, **kwargs)

TreeViewWrapper.Roots

pywinauto.controls.common_controls.TreeViewWrapper.Roots(*args, **kwargs)

TreeViewWrapper.Select

pywinauto.controls.common_controls.TreeViewWrapper.Select(*args, **kwargs)

TreeViewWrapper.ensure_visible

pywinauto.controls.common_controls.TreeViewWrapper.ensure_visible(path)

• 确保 TreeView 项可见

TreeViewWrapper.get_item

pywinauto.controls.common_controls.TreeViewWrapper.get_item(path, exact=False)

• 阅读 TreeView 项

• path 要返回的项的路径。这可以是以下方法之一：
  • 以 \ 个字符分隔的字符串。第一个字符必须是 \。此字符串在 \ 个字符上拆分，每个字符都用于查找每个级别的特定子项。\ 表示根项 - 因此无需指定根项本身。
  • 字符串列表/元组 - 第一项应为根元素。
  • 整数列表/元组 - 要选择的根的第一项索引。

TreeViewWrapper.get_properties

pywinauto.controls.common_controls.TreeViewWrapper.get_properties()

• 以字典形式获取控件的属性

TreeViewWrapper.is_selected

pywinauto.controls.common_controls.TreeViewWrapper.is_selected(path)

• 如果选中了项目，则返回 True

TreeViewWrapper.item

pywinauto.controls.common_controls.TreeViewWrapper.item(path, exact=False)

• 阅读 TreeView 项

• path 要返回的项的路径。这可以是以下方法之一：
  • 以 \ 个字符分隔的字符串。第一个字符必须是 \。此字符串在 \ 个字符上拆分，每个字符都用于查找每个级别的特定子项。\ 表示根项 - 因此无需指定根项本身。
  • 字符串列表/元组 - 第一项应为根元素。
  • 整数列表/元组 - 要选择的根的第一项索引。

TreeViewWrapper.item_count

pywinauto.controls.common_controls.TreeViewWrapper.item_count()

• 返回树视图中项目的计数

TreeViewWrapper.print_items

pywinauto.controls.common_controls.TreeViewWrapper.print_items()

• 打印所有带有行缩进的项目

TreeViewWrapper.roots

pywinauto.controls.common_controls.TreeViewWrapper.roots()

• 获取控件的根项

TreeViewWrapper.select

pywinauto.controls.common_controls.TreeViewWrapper.select(path)

• 选择树视图项

TreeViewWrapper.texts

pywinauto.controls.common_controls.TreeViewWrapper.texts()

• 返回树视图的所有文本

TreeViewWrapper.tree_root

pywinauto.controls.common_controls.TreeViewWrapper.tree_root()

• 返回树视图的根元素

TreeViewWrapper.writable_props

pywinauto.controls.common_controls.TreeViewWrapper.writable_props

• 扩展默认属性列表。

common_controls.UpDownWrapper

class pywinauto.controls.common_controls.UpDownWrapper(hwnd)

Windows UpDown 公共控件的类

UpDownWrapper.Decrement

pywinauto.controls.common_controls.UpDownWrapper.Decrement(*args, **kwargs)

UpDownWrapper.GetBase

pywinauto.controls.common_controls.UpDownWrapper.GetBase(*args, **kwargs)

UpDownWrapper.GetBuddyControl

pywinauto.controls.common_controls.UpDownWrapper.GetBuddyControl(*args, **kwargs)

UpDownWrapper.GetRange

pywinauto.controls.common_controls.UpDownWrapper.GetRange(*args, **kwargs)

UpDownWrapper.GetValue

pywinauto.controls.common_controls.UpDownWrapper.GetValue(*args, **kwargs)

UpDownWrapper.Increment

pywinauto.controls.common_controls.UpDownWrapper.Increment(*args, **kwargs)

UpDownWrapper.SetBase

pywinauto.controls.common_controls.UpDownWrapper.SetBase(*args, **kwargs)

UpDownWrapper.SetValue

pywinauto.controls.common_controls.UpDownWrapper.SetValue(*args, **kwargs)

UpDownWrapper.decrement

pywinauto.controls.common_controls.UpDownWrapper.decrement()

• 将 UpDown 控件中的数字递减 1

UpDownWrapper.get_base

pywinauto.controls.common_controls.UpDownWrapper.get_base()

• 获取 UpDown 控件（10 或 16）的基础

UpDownWrapper.get_buddy_control

pywinauto.controls.common_controls.UpDownWrapper.get_buddy_control()

• 获取上下控件的伙伴控制

UpDownWrapper.get_range

pywinauto.controls.common_controls.UpDownWrapper.get_range()

• 返回上下控件的下限、上限范围

UpDownWrapper.get_value

pywinauto.controls.common_controls.UpDownWrapper.get_value()

• 获取 UpDown 控件的当前值

UpDownWrapper.increment

pywinauto.controls.common_controls.UpDownWrapper.increment()

• 将 UpDown 控件中的数字递增 1

UpDownWrapper.set_base

pywinauto.controls.common_controls.UpDownWrapper.set_base(base_value)

• 获取 UpDown 控件（10 或 16）的基础

UpDownWrapper.set_value

pywinauto.controls.common_controls.UpDownWrapper.set_value(new_pos)

• 将 UpDown 控件的值设置为某个整数值