python桌面应用自动化，uiautomation模块的Depth和searchDepth心得

最近在学习yinkaisheng大神写的uiautomation模块，Depth和searchDepth一直使用不好，明明Depth=3，居然可以用searchDepth=1找到，网上也没找到答案，就自己试验了多次，终于发现了问题所在（主要是人比较笨），同时纠正下大神写的文档一处错误

自我理解：

searchDepth：查询的范围深度，基于当前所在控件再往下的深度，比如当前的listCtrl已经Depth=3了，如果要查listCtrl下Depth=5的控件，则searchDepth≥2都可查询当前这个控件

Depth：查询某一深度的控件，基于当前所在控件，再往下一个深度，只在那个深度进行查询，比如当前的listCtrl已经Depth=3了，如果要查listCtrl下Depth=5的控件，则Depth=2才能查到当前这个控件

图文解释：

用记事本做例子，代码是点击记事本的关闭按钮，执行代码如下：

notepadWindow = auto.WindowControl(searchDepth=1, ClassName='Notepad')
notepadWindow.ButtonControl(Depth=2,Name='关闭').Click()

通过automation.py捕捉到记事本的控件信息，并进行标记，可以很清楚的理解Depth、searchDepth：

由上图，我们如果想点击关闭按钮，那我们可以有好几种写法，如下：

1. 1 定位到记事本标题后再定位关闭： （标题是notepadWindow的下1层，所以Depth=1，关闭是标题的下一层，所以这个Depth也等于1）

notepadWindow.TitleBarControl(Depth=1).ButtonControl(Depth=1,Name='关闭')

1. 2 如果用searchDepth去写，只要searchDepth大于1，都可以查到，查到即停止

notepadWindow.TitleBarControl(Depth=1).ButtonControl(searchDepth=1,Name='关闭')
或：notepadWindow.TitleBarControl(Depth=1).ButtonControl(searchDepth=2,Name='关闭')

2. 1 直接定位到关闭按钮：（关闭是notepadWindow的下2层，所以Depth=2）

notepadWindow.ButtonControl(Depth=2,Name='关闭')

2. 2 如果用searchDepth去写，只要searchDepth大于2，都可以查到

notepadWindow.ButtonControl(searchDepth=2,Name='关闭')
或：notepadWindow.ButtonControl(searchDepth=3,Name='关闭')

 

注：如果查询参数中有Depth了，就不需要写searchDepth，Depth会把值赋值给searchDepth进行使用

整个分享就是这样啦，如果有什么不对的地方还请见谅