tdrpa.tdworker 1.1.9.3__py39-none-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. tdrpa/_tdxlwings/__init__.py +193 -0
  2. tdrpa/_tdxlwings/__pycache__/__init__.cpython-311.pyc +0 -0
  3. tdrpa/_tdxlwings/__pycache__/__init__.cpython-38.pyc +0 -0
  4. tdrpa/_tdxlwings/__pycache__/_win32patch.cpython-311.pyc +0 -0
  5. tdrpa/_tdxlwings/__pycache__/_win32patch.cpython-38.pyc +0 -0
  6. tdrpa/_tdxlwings/__pycache__/_xlwindows.cpython-311.pyc +0 -0
  7. tdrpa/_tdxlwings/__pycache__/_xlwindows.cpython-38.pyc +0 -0
  8. tdrpa/_tdxlwings/__pycache__/apps.cpython-311.pyc +0 -0
  9. tdrpa/_tdxlwings/__pycache__/apps.cpython-38.pyc +0 -0
  10. tdrpa/_tdxlwings/__pycache__/base_classes.cpython-311.pyc +0 -0
  11. tdrpa/_tdxlwings/__pycache__/base_classes.cpython-38.pyc +0 -0
  12. tdrpa/_tdxlwings/__pycache__/com_server.cpython-311.pyc +0 -0
  13. tdrpa/_tdxlwings/__pycache__/com_server.cpython-38.pyc +0 -0
  14. tdrpa/_tdxlwings/__pycache__/constants.cpython-311.pyc +0 -0
  15. tdrpa/_tdxlwings/__pycache__/constants.cpython-38.pyc +0 -0
  16. tdrpa/_tdxlwings/__pycache__/expansion.cpython-311.pyc +0 -0
  17. tdrpa/_tdxlwings/__pycache__/expansion.cpython-38.pyc +0 -0
  18. tdrpa/_tdxlwings/__pycache__/main.cpython-311.pyc +0 -0
  19. tdrpa/_tdxlwings/__pycache__/main.cpython-38.pyc +0 -0
  20. tdrpa/_tdxlwings/__pycache__/udfs.cpython-311.pyc +0 -0
  21. tdrpa/_tdxlwings/__pycache__/udfs.cpython-38.pyc +0 -0
  22. tdrpa/_tdxlwings/__pycache__/utils.cpython-311.pyc +0 -0
  23. tdrpa/_tdxlwings/__pycache__/utils.cpython-38.pyc +0 -0
  24. tdrpa/_tdxlwings/_win32patch.py +90 -0
  25. tdrpa/_tdxlwings/_xlmac.py +2240 -0
  26. tdrpa/_tdxlwings/_xlwindows.py +2518 -0
  27. tdrpa/_tdxlwings/addin/Dictionary.cls +474 -0
  28. tdrpa/_tdxlwings/addin/IWebAuthenticator.cls +71 -0
  29. tdrpa/_tdxlwings/addin/WebClient.cls +772 -0
  30. tdrpa/_tdxlwings/addin/WebHelpers.bas +3203 -0
  31. tdrpa/_tdxlwings/addin/WebRequest.cls +875 -0
  32. tdrpa/_tdxlwings/addin/WebResponse.cls +453 -0
  33. tdrpa/_tdxlwings/addin/xlwings.xlam +0 -0
  34. tdrpa/_tdxlwings/apps.py +35 -0
  35. tdrpa/_tdxlwings/base_classes.py +1092 -0
  36. tdrpa/_tdxlwings/cli.py +1306 -0
  37. tdrpa/_tdxlwings/com_server.py +385 -0
  38. tdrpa/_tdxlwings/constants.py +3080 -0
  39. tdrpa/_tdxlwings/conversion/__init__.py +103 -0
  40. tdrpa/_tdxlwings/conversion/framework.py +147 -0
  41. tdrpa/_tdxlwings/conversion/numpy_conv.py +34 -0
  42. tdrpa/_tdxlwings/conversion/pandas_conv.py +184 -0
  43. tdrpa/_tdxlwings/conversion/standard.py +321 -0
  44. tdrpa/_tdxlwings/expansion.py +83 -0
  45. tdrpa/_tdxlwings/ext/__init__.py +3 -0
  46. tdrpa/_tdxlwings/ext/sql.py +73 -0
  47. tdrpa/_tdxlwings/html/xlwings-alert.html +71 -0
  48. tdrpa/_tdxlwings/js/xlwings.js +577 -0
  49. tdrpa/_tdxlwings/js/xlwings.ts +729 -0
  50. tdrpa/_tdxlwings/mac_dict.py +6399 -0
  51. tdrpa/_tdxlwings/main.py +5205 -0
  52. tdrpa/_tdxlwings/mistune/__init__.py +63 -0
  53. tdrpa/_tdxlwings/mistune/block_parser.py +366 -0
  54. tdrpa/_tdxlwings/mistune/inline_parser.py +216 -0
  55. tdrpa/_tdxlwings/mistune/markdown.py +84 -0
  56. tdrpa/_tdxlwings/mistune/renderers.py +220 -0
  57. tdrpa/_tdxlwings/mistune/scanner.py +121 -0
  58. tdrpa/_tdxlwings/mistune/util.py +41 -0
  59. tdrpa/_tdxlwings/pro/__init__.py +40 -0
  60. tdrpa/_tdxlwings/pro/_xlcalamine.py +536 -0
  61. tdrpa/_tdxlwings/pro/_xlofficejs.py +146 -0
  62. tdrpa/_tdxlwings/pro/_xlremote.py +1293 -0
  63. tdrpa/_tdxlwings/pro/custom_functions_code.js +150 -0
  64. tdrpa/_tdxlwings/pro/embedded_code.py +60 -0
  65. tdrpa/_tdxlwings/pro/udfs_officejs.py +549 -0
  66. tdrpa/_tdxlwings/pro/utils.py +199 -0
  67. tdrpa/_tdxlwings/quickstart.xlsm +0 -0
  68. tdrpa/_tdxlwings/quickstart_addin.xlam +0 -0
  69. tdrpa/_tdxlwings/quickstart_addin_ribbon.xlam +0 -0
  70. tdrpa/_tdxlwings/quickstart_fastapi/main.py +47 -0
  71. tdrpa/_tdxlwings/quickstart_fastapi/requirements.txt +3 -0
  72. tdrpa/_tdxlwings/quickstart_standalone.xlsm +0 -0
  73. tdrpa/_tdxlwings/reports.py +12 -0
  74. tdrpa/_tdxlwings/rest/__init__.py +1 -0
  75. tdrpa/_tdxlwings/rest/api.py +368 -0
  76. tdrpa/_tdxlwings/rest/serializers.py +103 -0
  77. tdrpa/_tdxlwings/server.py +14 -0
  78. tdrpa/_tdxlwings/udfs.py +775 -0
  79. tdrpa/_tdxlwings/utils.py +777 -0
  80. tdrpa/_tdxlwings/xlwings-0.31.6.applescript +30 -0
  81. tdrpa/_tdxlwings/xlwings.bas +2061 -0
  82. tdrpa/_tdxlwings/xlwings_custom_addin.bas +2042 -0
  83. tdrpa/_tdxlwings/xlwingslib.cp38-win_amd64.pyd +0 -0
  84. tdrpa/tdworker/__init__.pyi +8 -0
  85. tdrpa/tdworker/_excel.pyi +703 -0
  86. tdrpa/tdworker/_img.pyi +173 -0
  87. tdrpa/tdworker/_os.pyi +46 -0
  88. tdrpa/tdworker/_w.pyi +129 -0
  89. tdrpa/tdworker/_web.pyi +248 -0
  90. tdrpa/tdworker/_winE.pyi +246 -0
  91. tdrpa/tdworker/_winK.pyi +74 -0
  92. tdrpa/tdworker/_winM.pyi +117 -0
  93. tdrpa/tdworker.cp39-win_amd64.pyd +0 -0
  94. tdrpa.tdworker-1.1.9.3.dist-info/METADATA +25 -0
  95. tdrpa.tdworker-1.1.9.3.dist-info/RECORD +97 -0
  96. tdrpa.tdworker-1.1.9.3.dist-info/WHEEL +5 -0
  97. tdrpa.tdworker-1.1.9.3.dist-info/top_level.txt +1 -0
@@ -0,0 +1,173 @@
1
+ from _typeshed import Incomplete
2
+ import uiautomation as uia
3
+
4
+ SCT: Incomplete
5
+
6
+ class Image:
7
+ @staticmethod
8
+ def Exists(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: float = 0.9, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, matchType: str = 'GrayMatch', backgroundPic: bool = False) -> bool:
9
+ '''
10
+ 判断图像是否存在
11
+
12
+ Image.Exists(\'d:\\test.jpg\', target, anchorsElement=None, rect=None, accuracy=0.9, searchDelay=10000, continueOnError=False, delayAfter=0, delayBefore=100, setForeground=True, matchType=\'GrayMatch\', backgroundPic=False)
13
+
14
+ :param imagePath:[必选参数]要查找的图片路径
15
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
16
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
17
+ :param rect:[可选参数]需要查找的范围,程序会在控件这个范围内进行图片识别,如果范围传递为 None,则进行控件矩形区域范围内的图片识别,如果范围传递为 {"x":10,"y":5,"width":200,"height":100},则进行控件矩形区域范围内以左上角向右偏移10像素、向下偏移5像素为起点,向右侧200,向下100的范围内的图片识别。默认None
18
+ :param accuracy:[可选参数]查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似。默认0.9
19
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
20
+ :param continueOnError:[可选参数]错误继续执行。默认False
21
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认0
22
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
23
+ :param setForeground:[可选参数]激活窗口。默认True
24
+ :param matchType:[可选参数]指定查找图像的匹配方式,\'GrayMatch\':“灰度匹配”速度快,但在极端情况下可能会匹配失败,\'ColorMatch\':“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。默认\'GrayMatch\'
25
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
26
+ :return:存在返回True,不存在返回False
27
+ '''
28
+ @staticmethod
29
+ def Find(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: int | float = 0.9, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, matchType: str = 'GrayMatch', backgroundPic: bool = False, iSerialNo: int = 0, returnPosition: str = 'center') -> dict | list | None:
30
+ '''
31
+ 查找图像
32
+
33
+ Image.Find(\'d:\\test.jpg\', target, anchorsElement=None, rect=None, accuracy=0.9, searchDelay=10000, continueOnError=False, delayAfter=0, delayBefore=100, setForeground=True, matchType=\'GrayMatch\', backgroundPic=False, iSerialNo=0, returnPosition="center")
34
+
35
+ :param imagePath:[必选参数]要查找的图片路径
36
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
37
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
38
+ :param rect:[可选参数]需要查找的范围,程序会在控件这个范围内进行图片识别,如果范围传递为 None,则进行控件矩形区域范围内的图片识别,如果范围传递为 {"x":10,"y":5,"width":200,"height":100},则进行控件矩形区域范围内以左上角向右偏移10像素、向下偏移5像素为起点,向右侧200,向下100的范围内的图片识别。默认None
39
+ :param accuracy:[可选参数]查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似。默认0.9
40
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
41
+ :param continueOnError:[可选参数]错误继续执行。默认False
42
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认0
43
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
44
+ :param setForeground:[可选参数]激活窗口。默认True
45
+ :param matchType:[可选参数]指定查找图像的匹配方式,\'GrayMatch\':“灰度匹配”速度快,但在极端情况下可能会匹配失败,\'ColorMatch\':“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。默认\'GrayMatch\'
46
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
47
+ :param iSerialNo:[可选参数]指定图像匹配到多个目标时的序号,序号为从1开始的正整数,在屏幕上从左到右从上到下依次递增,匹配到最靠近屏幕左上角的目标序号为1,如果是0,返回所有匹配图像的坐标。默认为0
48
+ :param returnPosition:[可选参数]\'center\':返回图片中心坐标,\'topLeft\':返回图片左上角坐标,\'topRight\':返回图片右上角坐标,\'bottomLeft\':返回图片左下角坐标,\'bottomRight\':返回图片右下角坐标。默认\'center\'
49
+ :return:返回图像的坐标,iSerialNo为0时,返回list,如[{\'x\':100, \'y\':100}, {\'x\':300,\'y\':300}],iSerialNo大于0时,返回dict,如{\'x\':100, \'y\':100},匹配不到时返回None
50
+ '''
51
+ @staticmethod
52
+ def Click(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: float = 0.9, button: str = 'left', clickType: str = 'click', searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True, cursorPosition: str = 'center', cursorOffsetX: int = 0, cursorOffsetY: int = 0, keyModifiers: list = None, simulateType: str = 'simulate', moveSmoothly: bool = False, matchType: str = 'GrayMatch', backgroundPic: bool = False, iSerialNo: int = 1):
53
+ '''
54
+ 点击图像
55
+
56
+ Image.Click(\'d:\\test.jpg\', target, anchorsElement=None, rect=None, accuracy=0.9, button=\'left\', clickType=\'click\', searchDelay=10000, continueOnError=False, delayAfter=100, delayBefore=100,
57
+ setForeground=True, cursorPosition=\'center\', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, simulateType=\'simulate\', moveSmoothly=False, matchType=\'GrayMatch\', backgroundPic=False, iSerialNo=1)
58
+
59
+ :param imagePath:[必选参数]要查找的图片路径
60
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
61
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
62
+ :param rect:[可选参数]需要查找的范围,程序会在控件这个范围内进行图片识别,如果范围传递为 None,则进行控件矩形区域范围内的图片识别,如果范围传递为 {"x":10,"y":5,"width":200,"height":100},则进行控件矩形区域范围内以左上角向右偏移10像素、向下偏移5像素为起点,向右侧200,向下100的范围内的图片识别。默认None
63
+ :param accuracy:[可选参数]查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似。默认0.9
64
+ :param button:[可选参数]鼠标点击。鼠标左键:"left" 鼠标右键:"right" 鼠标中键:"middle"。默认"left"
65
+ :param clickType:[可选参数]点击类型。单击:"click" 双击:"dbclick" 按下:"down" 弹起:"up"。默认"click"
66
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
67
+ :param continueOnError:[可选参数]错误继续执行。默认False
68
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
69
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
70
+ :param setForeground:[可选参数]激活窗口。默认True
71
+ :param cursorPosition:[可选参数]光标位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
72
+ :param cursorOffsetX:[可选参数]横坐标偏移。默认0
73
+ :param cursorOffsetY:[可选参数]纵坐标偏移。默认0
74
+ :param keyModifiers:[可选参数]辅助按键["Alt","Ctrl","Shift","Win"]可多选。默认None
75
+ :param simulateType:[可选参数]操作类型。模拟操作:"simulate" 消息操作:"message"。默认"simulate"
76
+ :param moveSmoothly:[可选参数]是否平滑移动鼠标。默认False
77
+ :param matchType:[可选参数]指定查找图像的匹配方式,\'GrayMatch\':“灰度匹配”速度快,但在极端情况下可能会匹配失败,\'ColorMatch\':“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。默认\'GrayMatch\'
78
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。注意:当simulateType为message时,该字段设置为True才会生效
79
+ :param iSerialNo:[可选参数]指定图像匹配到多个目标时的序号,序号为从1开始的正整数,在屏幕上从左到右从上到下依次递增,匹配到最靠近屏幕左上角的目标序号为1,如果是0,匹配所有图片(即点击所有匹配到的图片)。默认为1
80
+ :return:None
81
+ '''
82
+ @staticmethod
83
+ def Hover(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: float = 0.9, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True, cursorPosition: str = 'center', cursorOffsetX: int = 0, cursorOffsetY: int = 0, keyModifiers: list = None, moveSmoothly: bool = False, matchType: str = 'GrayMatch', backgroundPic: bool = False, iSerialNo: int = 1):
84
+ '''
85
+ 鼠标移动到图像上
86
+
87
+ Image.Hover(\'d:\\test.jpg\', target, anchorsElement=None, rect=None, accuracy=0.9, searchDelay=10000, continueOnError=False, delayAfter=100, delayBefore=100,
88
+ setForeground=True, cursorPosition=\'center\', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, moveSmoothly=False, matchType=\'GrayMatch\', backgroundPic=False, iSerialNo=1)
89
+
90
+ :param imagePath:[必选参数]要查找的图片路径
91
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
92
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
93
+ :param rect:[可选参数]需要查找的范围,程序会在控件这个范围内进行图片识别,如果范围传递为 None,则进行控件矩形区域范围内的图片识别,如果范围传递为 {"x":10,"y":5,"width":200,"height":100},则进行控件矩形区域范围内以左上角向右偏移10像素、向下偏移5像素为起点,向右侧200,向下100的范围内的图片识别。默认None
94
+ :param accuracy:[可选参数]查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似。默认0.9
95
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
96
+ :param continueOnError:[可选参数]错误继续执行。默认False
97
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
98
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
99
+ :param setForeground:[可选参数]激活窗口。默认True
100
+ :param cursorPosition:[可选参数]光标位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
101
+ :param cursorOffsetX:[可选参数]横坐标偏移。默认0
102
+ :param cursorOffsetY:[可选参数]纵坐标偏移。默认0
103
+ :param keyModifiers:[可选参数]辅助按键["Alt","Ctrl","Shift","Win"]可多选。默认None
104
+ :param moveSmoothly:[可选参数]是否平滑移动鼠标。默认False
105
+ :param matchType:[可选参数]指定查找图像的匹配方式,\'GrayMatch\':“灰度匹配”速度快,但在极端情况下可能会匹配失败,\'ColorMatch\':“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。默认\'GrayMatch\'
106
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
107
+ :param iSerialNo:[可选参数]指定图像匹配到多个目标时的序号,序号为从1开始的正整数,在屏幕上从左到右从上到下依次递增,匹配到最靠近屏幕左上角的目标序号为1,如果是0,匹配所有图片(即鼠标将移动经过所有匹配到的图片)。默认为1
108
+ :return:None
109
+ '''
110
+ @staticmethod
111
+ def Wait(imagePath: str, target: str | uia.Control, anchorsElement: uia.Control | None = None, rect: dict | None = None, accuracy: float = 0.9, waitType: str = 'show', searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, matchType: str = 'GrayMatch', backgroundPic: bool = False):
112
+ '''
113
+ 等待图片显示或消失
114
+
115
+ Image.Wait(\'d:\\test.jpg\', target, anchorsElement=None, rect=None, accuracy=0.9, waitType="show", searchDelay=10000, continueOnError=False, delayAfter=0, delayBefore=100, setForeground=True, matchType=\'GrayMatch\', backgroundPic=False)
116
+
117
+ :param imagePath:[必选参数]要查找的图片路径
118
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
119
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
120
+ :param rect:[可选参数]需要查找的范围,程序会在控件这个范围内进行图片识别,如果范围传递为 None,则进行控件矩形区域范围内的图片识别,如果范围传递为 {"x":10,"y":5,"width":200,"height":100},则进行控件矩形区域范围内以左上角向右偏移10像素、向下偏移5像素为起点,向右侧200,向下100的范围内的图片识别。默认None
121
+ :param accuracy:[可选参数]查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似。默认0.9
122
+ :param waitType:[可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
123
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
124
+ :param continueOnError:[可选参数]错误继续执行。默认False
125
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认0
126
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
127
+ :param setForeground:[可选参数]激活窗口。默认True
128
+ :param matchType:[可选参数]指定查找图像的匹配方式,\'GrayMatch\':“灰度匹配”速度快,但在极端情况下可能会匹配失败,\'ColorMatch\':“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢。默认\'GrayMatch\'
129
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
130
+ :return:None
131
+ '''
132
+ @staticmethod
133
+ def ComColor(rgbHex, target: str | uia.Control, anchorsElement: uia.Control | None = None, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, beginPosition: str = 'center', positionOffsetX: int = 0, positionOffsetY: int = 0, backgroundPic: bool = False):
134
+ '''
135
+ 目标内指定位置比色
136
+
137
+ Image.ComColor(\'FF0000\', target, anchorsElement=None, searchDelay=10000, continueOnError=False, delayAfter=0, delayBefore=100, setForeground=True, beginPosition=\'center\', positionOffsetX=0, positionOffsetY=0, backgroundPic=False)
138
+
139
+ :param rgbHex: 十六进制颜色,RGB色值,例如:"FF0000",支持偏色,如"FF0000-101010"
140
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
141
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
142
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
143
+ :param continueOnError:[可选参数]错误继续执行。默认False
144
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认0
145
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
146
+ :param setForeground:[可选参数]激活窗口。默认True
147
+ :param beginPosition:[可选参数]起始位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
148
+ :param positionOffsetX:[可选参数]横坐标偏移。默认0
149
+ :param positionOffsetY:[可选参数]纵坐标偏移。默认0
150
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
151
+ :return:匹配返回True,不匹配返回False
152
+ '''
153
+ @staticmethod
154
+ def GetColor(target, anchorsElement: Incomplete | None = None, searchDelay: int = 10000, continueOnError: bool = False, delayAfter: int = 0, delayBefore: int = 100, setForeground: bool = True, beginPosition: str = 'center', positionOffsetX: int = 0, positionOffsetY: int = 0, backgroundPic: bool = False):
155
+ '''
156
+ 获取目标指定位置的颜色值(16进制RGB字符)
157
+
158
+ Image.GetColor(target, anchorsElement=None, searchDelay=10000, continueOnError=False, delayAfter=0, delayBefore=100, setForeground=True, beginPosition=\'center\', positionOffsetX=0, positionOffsetY=0, backgroundPic=False)
159
+
160
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
161
+ :param anchorsElement:[可选参数]从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
162
+ :param searchDelay:[可选参数]超时时间(毫秒)。默认10000
163
+ :param continueOnError:[可选参数]错误继续执行。默认False
164
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认0
165
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
166
+ :param setForeground:[可选参数]激活窗口。默认True
167
+ :param beginPosition:[可选参数]起始位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
168
+ :param positionOffsetX:[可选参数]横坐标偏移。默认0
169
+ :param positionOffsetY:[可选参数]纵坐标偏移。默认0
170
+ :param backgroundPic:[可选参数]是否后台识图片(图片需与查找范围在同一窗口)。True为后台识别图片,False为前台识别图片。默认False。
171
+ :return:返回颜色值(16进制的RGB字符)
172
+ '''
173
+
tdrpa/tdworker/_os.pyi ADDED
@@ -0,0 +1,46 @@
1
+ class App:
2
+ @staticmethod
3
+ def Kill(processName: str | int) -> bool:
4
+ """
5
+ 强制停止应用程序的运行(结束进程)
6
+
7
+ App.Kill('chrome.exe')
8
+
9
+ :param processName:[必选参数]应用程序进程名或进程PID,忽略大小写字母
10
+ :return:命令执行成功返回True,失败返回False
11
+ """
12
+ @staticmethod
13
+ def GetStatus(processName: str | int, status: int = 0) -> bool:
14
+ """
15
+ 获取应用运行状态
16
+
17
+ App.GetStatus('chrome.exe', status=0)
18
+
19
+ :param processName:[必选参数]应用程序进程名或进程PID,忽略大小写字母
20
+ :param status:[可选参数]筛选进程状态。0:所有状态 1:运行 2:暂停 3:未响应 4:未知。默认0
21
+ :return:进程存在返回True,不存在返回False
22
+ """
23
+ @staticmethod
24
+ def Run(exePath, waitType: int = 0, showType: int = 1):
25
+ """
26
+ 启动应用程序
27
+
28
+ App.Run('''C:\\Windows\\system32\\mspaint.exe''')
29
+
30
+ :param exePath:[必选参数]应用程序文件路径
31
+ :param waitType:[可选参数]0:等待 1:等待应用程序准备好 2:等待应用程序执行到退出。默认0
32
+ :param showType:[可选参数]程序启动后的显示样式(不一定生效) 0:隐藏 1:默认 3:最大化 6:最小化
33
+ :return:返回应用程序的PID
34
+ """
35
+ @staticmethod
36
+ def WaitProcess(processName, waitType: str = 'open', delayTime: int = 30000) -> bool:
37
+ '''
38
+ 等待应用启动或关闭
39
+
40
+ App.WaitProcess(\'chrome.exe\', waitType=\'open\', delayTime=30000)
41
+
42
+ :param processName:[必选参数]进程名称,忽略大小写字母。如:"chrome.exe"
43
+ :param waitType:[可选参数]期望应用状态。open:等待应用打开 close:等待应用关闭
44
+ :param delayTime:[可选参数]最大等待时间,默认30000毫秒(即30秒)
45
+ :return:等待时间内达到期望应用状态(开启/关闭)返回True,否则返回False
46
+ '''
tdrpa/tdworker/_w.pyi ADDED
@@ -0,0 +1,129 @@
1
+ import uiautomation as uia
2
+
3
+ class Window:
4
+ @staticmethod
5
+ def Close(target: str | uia.Control) -> None:
6
+ """
7
+ 关闭窗口
8
+
9
+ Window.Close(target)
10
+
11
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
12
+ :return: None
13
+ """
14
+ @staticmethod
15
+ def GetActive(isReturnHwnd: bool = True) -> uia.Control | int:
16
+ """
17
+ 获取活动窗口
18
+
19
+ Window.GetActive(isReturnHwnd=True)
20
+
21
+ :param isReturnHwnd: [可选参数]是否返回窗口句柄,True时函数返回窗口句柄,False时返回窗口元素对象。默认True
22
+ :return:窗口句柄或者窗口元素对象
23
+ """
24
+ @staticmethod
25
+ def SetActive(target: str | uia.Control) -> bool:
26
+ """
27
+ 设置活动窗口
28
+
29
+ Window.SetActive(target)
30
+
31
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
32
+ :return: bool。激活成功返回True,否则返回False
33
+ """
34
+ @staticmethod
35
+ def Show(target: str | uia.Control, showStatus: str = 'show') -> bool:
36
+ '''
37
+ 更改窗口显示状态
38
+
39
+ Window.Show(target, showStatus="show")
40
+
41
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
42
+ :param showStatus: [可选参数] 显示:\'show\' 隐藏:\'hide\' 最大化:\'max\' 最小化:\'min\' 还原:\'restore\'。默认\'show\'
43
+ :return: bool。执行成功返回True,否则返回False
44
+ '''
45
+ @staticmethod
46
+ def Exists(target: str | uia.WindowControl) -> bool:
47
+ """
48
+ 判断窗口是否存在
49
+
50
+ Window.Exists(target)
51
+
52
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象
53
+ :return: bool。窗口存在返回True,否则返回False
54
+ """
55
+ @staticmethod
56
+ def GetSize(target: str | uia.Control) -> dict:
57
+ '''
58
+ 获取窗口大小
59
+
60
+ Window.GetSize(target)
61
+
62
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
63
+ :return: {"height":int, "width":int, "x":int, "y":int}
64
+ '''
65
+ @staticmethod
66
+ def SetSize(target: str | uia.Control, width: int, height: int) -> None:
67
+ """
68
+ 改变窗口大小
69
+
70
+ Window.SetSize(target, 800, 600)
71
+
72
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
73
+ :param width: [必选参数]窗口宽度
74
+ :param height: [必选参数]窗口高度
75
+ :return: None
76
+ """
77
+ @staticmethod
78
+ def Move(target: str | uia.Control, x: int, y: int) -> None:
79
+ """
80
+ 移动窗口位置
81
+
82
+ Window.Move(target, 0, 0)
83
+
84
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
85
+ :param x: [必选参数]移动到新位置的横坐标
86
+ :param y: [必选参数]移动到新位置的纵坐标
87
+ :return: None
88
+ """
89
+ @staticmethod
90
+ def TopMost(target: str | uia.Control, isTopMost: bool = True) -> bool:
91
+ """
92
+ 窗口置顶
93
+
94
+ Window.TopMost(target, isTopMost=True)
95
+
96
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
97
+ :param isTopMost: [可选参数]是否使窗口置顶,窗口置顶:true 窗口取消置顶:false。默认True
98
+ :return: bool值,设置成功返回True,否则返回False
99
+ """
100
+ @staticmethod
101
+ def GetClass(target: str | uia.Control) -> str:
102
+ """
103
+ 获取窗口类名
104
+
105
+ Window.GetClass(target)
106
+
107
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
108
+ :return: 窗口的类名称
109
+ """
110
+ @staticmethod
111
+ def GetPath(target: str | uia.Control) -> str:
112
+ """
113
+ 获取窗口程序的文件路径
114
+
115
+ Window.GetPath(target)
116
+
117
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
118
+ :return: 文件绝对路径
119
+ """
120
+ @staticmethod
121
+ def GetPID(target: str | uia.Control) -> int:
122
+ """
123
+ 获取进程PID
124
+
125
+ Window.GetPID(target)
126
+
127
+ :param target: [必选参数]tdRPA拾取器获取的目标窗口元素特征字符串或uia目标窗口元素对象,也可选取窗口内始终存在的元素。
128
+ :return: PID
129
+ """
@@ -0,0 +1,248 @@
1
+ from _typeshed import Incomplete
2
+ from playwright.sync_api import ElementHandle, Page as Page
3
+
4
+ class Web:
5
+ @staticmethod
6
+ def Exists(tdstr: str, anchorsElement, isVisible: bool = True) -> bool:
7
+ """
8
+ 元素是否存在(不可见归于不存在)
9
+
10
+ Web.Exists(tdstr, page, isVisible=True)
11
+
12
+ :param tdstr: td字符串
13
+ :param anchorsElement: 锚点参数
14
+ :param isVisible:[可选参数]检查是否可见。默认True
15
+ :return: bool
16
+ """
17
+
18
+ @staticmethod
19
+ def Wait(tdstr: str, anchorsElement, waitType: str = 'show', searchDelay: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> None:
20
+ '''
21
+ 等待元素加载
22
+
23
+ Web.Wait(tdstr, page, waitType=\'show\', searchDelay=10000, continueOnError=False, isVisible=True)
24
+
25
+ :param tdstr: td字符串
26
+ :param anchorsElement: 锚点元素
27
+ :param waitType: [可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
28
+ :param searchDelay:[可选参数]等待最大时间。默认10000毫秒(10秒)
29
+ :param continueOnError: [可选参数]错误继续执行。默认False
30
+ :param isVisible:[可选参数]检查是否可见。默认True
31
+ :return: None
32
+ '''
33
+
34
+ @staticmethod
35
+ def GetParentElement(eh: ElementHandle) -> ElementHandle:
36
+ """
37
+ 获取父级元素
38
+
39
+ eh = Web.GetParentElement(eh)
40
+
41
+ :param eh: ElementHandle
42
+ :return: ElementHandle
43
+ """
44
+
45
+ @staticmethod
46
+ def GetNextSiblingElement(eh: ElementHandle) -> ElementHandle:
47
+ """
48
+ 获取下一个兄弟元素
49
+
50
+ eh = Web.GetNextSiblingElement(eh)
51
+
52
+ :param eh: ElementHandle
53
+ :return: ElementHandle
54
+ """
55
+
56
+ @staticmethod
57
+ def GetPreviousSiblingElement(eh: ElementHandle) -> ElementHandle:
58
+ """
59
+ 获取前一个兄弟元素
60
+
61
+ eh = Web.GetPreviousSiblingElement(eh)
62
+
63
+ :param eh: ElementHandle
64
+ :return: ElementHandle
65
+ """
66
+
67
+ @staticmethod
68
+ def GetChildrenElements(eh) -> list:
69
+ """
70
+ 获取子节点
71
+
72
+ ehList = Web.GetChildrenElements(eh)
73
+
74
+ :param eh: ElementHandle
75
+ :return: list[ElementHandle, ElementHandle, ...]
76
+ """
77
+
78
+ @staticmethod
79
+ def Click(target: str | ElementHandle, anchorsElement: Incomplete | None = None, position: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
80
+ """
81
+ 点击元素
82
+
83
+ eh = Web.Click(target, page, position=None, delayTime=10000)
84
+
85
+ :param target: tdstr 或 ElementHandle
86
+ :param anchorsElement: 锚点元素
87
+ :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
88
+ :param delayTime: 超时(豪秒)。默认10000
89
+ :return: ElementHandle
90
+ """
91
+
92
+ @staticmethod
93
+ def Hover(target: str | ElementHandle, anchorsElement: Incomplete | None = None, position: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
94
+ """
95
+ 鼠标悬停在元素上
96
+
97
+ eh = Web.Hover(target, page, position=None, delayTime=10000)
98
+
99
+ :param target: tdstr 或 ElementHandle
100
+ :param anchorsElement: 锚点元素
101
+ :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
102
+ :param delayTime: 超时(豪秒)。默认10000
103
+ :return: ElementHandle
104
+ """
105
+
106
+ @staticmethod
107
+ def Input(text, target, anchorsElement: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
108
+ """
109
+ 输入文本
110
+
111
+ eh = Web.Input(text, target, page, delayTime=10000)
112
+
113
+ :param text: 文本内容
114
+ :param target: tdstr 或 ElementHandle
115
+ :param anchorsElement: 锚点元素
116
+ :param delayTime: 超时(豪秒)。默认10000
117
+ :return: ElementHandle
118
+ """
119
+
120
+ @staticmethod
121
+ def ClickLinkOpenNewPage(eh, position: Incomplete | None = None, waitLoad: bool = False) -> Page:
122
+ """
123
+ 点击连接产生新的标签页
124
+
125
+ newPage = Web.ClickLinkOpenNewPage(eh, position=None, waitLoad=False)
126
+
127
+ :param eh: ElementHandle
128
+ :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
129
+ :param waitLoad: 是否等待新页面加载完毕。默认False
130
+ :return: newPage
131
+ """
132
+
133
+ @staticmethod
134
+ def FindWebElement(tdstr: str, anchorsElement, searchDelay: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
135
+ """
136
+ 查找元素
137
+
138
+ eh = Web.FindWebElement(tdstr, page, searchDelay=10000, continueOnError=False, isVisible=True)
139
+
140
+ :param tdstr: td字符串
141
+ :param anchorsElement: 锚点参数
142
+ :param searchDelay: 查找延时(豪秒)。默认10000
143
+ :param continueOnError: 错误继续执行。默认False
144
+ :param isVisible:检查是否可见。默认True
145
+ :return: ElementHandle
146
+ """
147
+
148
+ @staticmethod
149
+ def PwStart(port: int = 9222, magic: bool = True) -> Page:
150
+ """
151
+ 绑定浏览器
152
+
153
+ page = Web.PwStart()
154
+
155
+ :return: firstPage
156
+ """
157
+
158
+ @staticmethod
159
+ def OpenChrome(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportUia: bool = True, otherStartupParam: Incomplete | None = None, env_variables: Incomplete | None = None, delayTime: int = 30000) -> None:
160
+ '''
161
+ 启动谷歌浏览器
162
+
163
+ Web.OpenChrome(url="www.baidu.com", chromeExePath=None, isMaximize=True, supportUia=True, otherStartupParam=None, env_variables=None, delayTime=30000)
164
+
165
+ :param url:[可选参数]启动浏览器后打开的链接,字符串类型。默认None
166
+ :param chromeExePath:[可选参数]谷歌浏览器可执行程序的绝对路径,字符串类型,填写None时会自动寻找本地安装的路径。默认None
167
+ :param isMaximize:[可选参数]浏览器启动后是否最大化显示,选择True时最大化启动,选择False默认状态。默认True
168
+ :param supportUia:[可选参数]是否支持uiautomatin,True支持,False不支持。默认True
169
+ :param otherStartupParam:[可选参数]其他启动谷歌浏览器的参数,如:[\'--xxx\', \'--xxx\']。默认None
170
+ :param env_variables:[可选参数]启动浏览器进程时附带的环境变量,如{"a": "abc"}
171
+ :param delayTime: 浏览器进程加载超时(毫秒)。默认30000
172
+ :return:None
173
+ '''
174
+
175
+ @staticmethod
176
+ def ChromeProcessStatus() -> bool:
177
+ """
178
+ 检查启动的Chrome浏览器进程是否正在运行
179
+
180
+ chromeStatus = Web.ChromeProcessStatus()
181
+
182
+ :return:返回True时,表示浏览器仍在运行,返回False时,表示浏览器非运行状态
183
+ """
184
+
185
+ @staticmethod
186
+ def TopMost() -> None:
187
+ """
188
+ 浏览器置顶
189
+
190
+ Web.TopMost()
191
+
192
+ """
193
+
194
+
195
+ class ChromePlugin:
196
+ @staticmethod
197
+ def Open(url: Incomplete | None = None, clearChrome: bool = True, userData: Incomplete | None = None) -> None:
198
+ """
199
+ 启动新的浏览器
200
+
201
+ ChromePlugin.Open(url='www.baidu.com', clearChrome=True, userData=None)
202
+
203
+ """
204
+
205
+ @staticmethod
206
+ def JS(js_str, returnList: bool = False):
207
+ """
208
+ 执行JS注入
209
+
210
+ ChromePlugin.JS(js_str, returnList=False)
211
+
212
+ """
213
+
214
+ @staticmethod
215
+ def Close(tryClose: int = 3, userData: Incomplete | None = None) -> None:
216
+ """
217
+ 关闭chrome
218
+
219
+ ChromePlugin.Close(tryClose=3, userData=None)
220
+
221
+ """
222
+
223
+ @staticmethod
224
+ def WaitLoading(delayTime: int = 60000) -> None:
225
+ """
226
+ 等待加载
227
+
228
+ ChromePlugin.WaitLoading(delayTime=60000)
229
+
230
+ """
231
+
232
+ @staticmethod
233
+ def Reload() -> None:
234
+ """
235
+ 刷新页面
236
+
237
+ ChromePlugin.Reload()
238
+
239
+ """
240
+
241
+ @staticmethod
242
+ def GoUrl(url, isWaitLoading: bool = True, delayTime: int = 60000) -> None:
243
+ """
244
+ 跳转页面
245
+
246
+ ChromePlugin.GoUrl('https://www.baidu.com', isWaitLoading=True, delayTime=60000)
247
+
248
+ """