Item module

元素控件类，通过此类对象可以获取元素信息和对其进行操作。

class Item(d: <module 'uitestrunner_syberos.Device' from '/home/runner/work/uitestrunner_syberos/uitestrunner_syberos/src/uitestrunner_syberos/Device.py'>, s: str = '', xpath: str = '', node=None)

基类：object

元素控件类，通过Device.find_item_by_xpath_key()与Device.find_item_by_xpath()两个接口结果返回实例化对象，不推荐单独使用。

变量

• sopid – 元素控件所在的应用sopid

• device – 实例化的Device对象

• node – 对应的xml节点对象

• xpath – xpath字符串

attributes(refresh: bool = False) → Dict

获取当前Item对象的属性字典。

参数

refresh – 是否刷新布局信息(默认值False)

返回

属性字典

center_x_to_global(refresh: bool = False) → int

获取元素控件的中心点相对于全局的映射横坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

横坐标整数值

center_x_to_item(refresh: bool = False) → int

获取元素控件的中心点相对于父对象的映射横坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

横坐标整数值

center_y_to_global(refresh: bool = False) → int

获取元素控件的中心点相对于全局的映射纵坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

纵坐标整数值

center_y_to_item(refresh: bool = False) → int

获取元素控件的中心点相对于父对象的映射纵坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

纵坐标整数值

children(filter_condition: Optional[dict] = None, refresh: bool = False) → List[uitestrunner_syberos.Item.Item]

获取当前Item对象的子对象列表。

参数

• filter_condition – 用于筛选子对象的属性条件字典

• refresh – 是否刷新布局信息(默认值False)

返回

子对象列表

class_name(refresh: bool = False) → str

获取元素控件的类名。

参数

refresh – 是否刷新布局信息(默认值False)

返回

类名字符串

click(delay: int = 0) → bool

点击元素控件。

参数

delay – 点击延时时间(单位:毫秒), 默认无延时

返回

成功返回True，否则为False

click_exist(delay: int = 0, timeout: Optional[int] = None) → bool

判断元素控件是否显示，显示则执行点击操作。

参数

• delay – 点击延时时间(单位:毫秒), 默认无延时

• timeout – 超时时间(单位:秒)，默认为框架超时时间

返回

点击成功返回True，否则返回False，若不存在则中断

clip(refresh: bool = False) → bool

获取元素控件是否启用了裁切属性。

参数

refresh – 是否刷新布局信息(默认值False)

返回

bool值，开启裁切为True，否则为False

contrast_picture(path: str, scale: bool = False) → float

使用本地的图片文件与当前元素控件截图进行图片比对。

参数

• path – 本地的图片路径

• scale – 对比之前是否通过缩放来统一二者尺寸，默认为否

返回

对比值，值越小越相似

contrast_picture_from_base64(pic: str, scale: bool = False) → float

使用图片的base64字符串与当前元素控件截图进行图片比对。

参数

• pic – 图片的base64字符串

• scale – 对比之前是否通过缩放来统一二者尺寸，默认为否

返回

对比值，值越小越相似

drag(p: uitestrunner_syberos.DataStruct.Point, delay: int = 1)

判断元素控件是否显示，显示则执行点击操作。

参数

• p – 坐标点类Point对象，目标点

• delay – 起始点长按时间，默认1秒

返回

成功返回True，否则为False

enabled(refresh: bool = False) → bool

获取元素控件的enabled属性。

参数

refresh – 是否刷新布局信息(默认值False)

返回

属性值，True为开启，否则为False

exist(timeout: Optional[int] = None) → bool

判断元素控件是否显示。

参数

timeout – 超时时间(单位:秒)，默认为框架超时时间

返回

显示为True，超时未显示为False

focus(refresh: bool = False) → bool

获取元素控件是否拥有焦点。

参数

refresh – 是否刷新布局信息(默认值False)

返回

属性值，拥有焦点为True，否则为False

grab_image_to_base64() → str

获取元素控件的显示范围截图。

返回

截图的base64形态

has_contents(refresh: bool = False) → bool

判断元素控件是否拥有可视内容。

参数

refresh – 是否刷新布局信息(默认值False)

返回

属性值，拥有可视内容为True，否则为False

height(refresh: bool = False) → int

获取元素控件的高度整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

高度整数值

index(refresh: bool = False) → int

获取当前Item对象相对于所有兄弟对象的索引值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

索引值

index_by_same_tag(refresh: bool = False) → int

获取当前Item对象相对于同类兄弟对象的索引值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

索引值

next(refresh: bool = False) → uitestrunner_syberos.Item.Item

获取当前Item对象的后一位兄弟对象，如没有则返回None。

参数

refresh – 是否刷新布局信息(默认值False)

返回

后一位兄弟对象或None

next_by_same_tag(refresh: bool = False) → uitestrunner_syberos.Item.Item

获取当前Item对象的后一位同类兄弟对象，如没有则返回None。

参数

refresh – 是否刷新布局信息(默认值False)

返回

后一位同类兄弟对象或None

object_name(refresh: bool = False) → str

获取元素控件的对象名称，此属性对应开发过程中的qml的id属性，但实际此属性在全局并非绝对唯一。

参数

refresh – 是否刷新布局信息(默认值False)

返回

对象名称字符串

opacity(refresh: bool = False) → float

获取元素控件的透明度(0-1的浮点数)。

参数

refresh – 是否刷新布局信息(默认值False)

返回

透明度值

parent(refresh: bool = False) → uitestrunner_syberos.Item.Item

获取当前Item对象的父对象，如没有则返回None。

参数

refresh – 是否刷新布局信息(默认值False)

返回

父亲对象或None

previous(refresh: bool = False) → uitestrunner_syberos.Item.Item

获取当前Item对象的前一位兄弟对象，如没有则返回None。

参数

refresh – 是否刷新布局信息(默认值False)

返回

前一位兄弟对象或None

previous_by_same_tag(refresh: bool = False) → uitestrunner_syberos.Item.Item

获取当前Item对象的前一位同类兄弟对象，如没有则返回None。

参数

refresh – 是否刷新布局信息(默认值False)

返回

前一位同类兄弟对象或None

rotation(refresh: bool = False) → int

获取元素控件的顺时针旋转角度。

参数

refresh – 是否刷新布局信息(默认值False)

返回

角度值

scale(refresh: bool = False) → float

获取元素控件的缩放系数。

参数

refresh – 是否刷新布局信息(默认值False)

返回

缩放系数

submit_string(text: str) → bool

向元素控件提交文本(模拟输入法事件)。

参数

text – 要提交的文本字符串

返回

成功返回True，否则为False

temp_id(refresh: bool = False) → str

获取元素控件的临时标识符。

参数

refresh – 是否刷新布局信息(默认值False)

返回

标识符字符串

text(refresh: bool = False) → str

获取元素控件的文本信息。

参数

refresh – 是否刷新布局信息(默认值False)

返回

文本字符串

visible(refresh: bool = False) → bool

获取元素控件的可访问属性。

参数

refresh – 是否刷新布局信息(默认值False)

返回

属性值，True为开启，否则为False

width(refresh: bool = False) → int

获取元素控件的宽度整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

宽度整数值

x(refresh: bool = False) → int

获取元素控件的左上角横坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

横坐标整数值

y(refresh: bool = False) → int

获取元素控件的左上角纵坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

纵坐标整数值

z(refresh: bool = False) → int

获取元素控件的z轴坐标整数值。

参数

refresh – 是否刷新布局信息(默认值False)

返回

z轴坐标整数值