HOWTO: Windows技术对Qt中Table的自动化

这里会介绍Qt中Table控件的自动化。我们以Qt Demo提供的SpreadSheet为例进行讲解。 iamge

Table控件特点

简单控件在自动化过程中，一般通过在模型管理器中先做对象拾取，添加到对象模型中，最后将对象拖拽到代码编辑器中，生成获取对象的get[ControlType]的方法，以及操作它的方法。

Table控件有行、单元格等子控件，使用上述传统的方法并不能有效灵活的操作Table控件的行和单元格等子元素，

首先对Qt Table中的各个部分进行控件类型分析，一张完整的表通常由以下控件构成。 在Qt 4.x版本中，Table中使用了Custom控件充当表格的行；而在5.x版本中，则直接放弃了使用Custom转而将表格的中的所有控件堆到了一起。

Qt 4.x: 
    - Table 表格控件
        - Custom 行控件
            - Header 表头控件，无法编辑
            - DataItem 单元格控件，双击后可编辑

Qt 5.x: 
    - Table 表格控件
        - Header 表头控件，无法编辑
        - DataItem 单元格控件，双击后可编辑

从模型管理器识别到的测试对象树中也可以看出来表格中的结构。

Qt 4.x SpreadSheet中识别到的对象树
Qt 5.x SpreadSheet中识别到的对象树

由于结构的不同，获取这些单元格，也就是DataItem控件的方法也有细微的区别。

操作Table中的单元格

为操作Table控件中的某个单元格，首先要在自动化过程中动态定位到它。有两种方式可以实现。

方法1. 利用模型中的行和单元格控件，动态设定index属性

仍旧使用get[ControlType]API，具体查看获取对象API，在获取模型对象时动态提供index属性，例如，已知目标单元格的位置信息，比如n行m列。假设我们需要获取表格中A6单元格的控件对象，可以直接利用位置信息来获取，代码如下：

JavaScript
Python
let target = {
    row: 6,
    column: 0
}
let row = model.getTable("Table").getCustom({ index: target.row });
let cell = row.getDataItem({ index: target.column });
console.log(await cell.value());
target = {
    "row": 6,
    "column": 0
}

row = model.getTable("Table").getCustom({"index": target["row"]})
cell = row.getDataItem({"index": target["column"]})
print(cell.value())
结果如下：

image

如果是Qt 5.x版本，由于缺少了行控件，因此直接从Table控件下直接取到所有的DataItem控件的对象以数组的形式储存，取出目标控件需要把位置信息换算：

JavaScript
Python
let target = {
    row: 5, 
    column: 0
}
let cell = await model.getTable("Table").getDataItem({index: target.row * 6 + target.column});
console.log(await cell.name())
target = {
    "row": 5,
    "column": 0
}

index = target["row"] * 6 + target["column"]
cell = model.getTable("Table").getDataItem({"index": index})
print(cell.name())

该代码获取的是第6行第1个单元格的对象控件。Table控件中每行有6个DataItem, 那么第n行m列的单元格控件为索引为（n * 6 + m）个DataItem控件。

image

方法2: 通过findControls调用动态拿到控件数组，批量操作

上述方法能够拿到单个的单元格控件，然后操作这个单元格。有时我们需要批量操作多个单元格。这时候可以利用findControls方法，它可以返回一组符合过滤条件的子控件。

如需要遍历表格获取符合条件的单元格，那么就可以先取到所有控件对象，再筛选出满足条件的对象。假设我们需要输出表格中所有价格大于0的项目，就可以取出所有控件，经过筛选后输出，代码如下：

JavaScript
Python
let table = await model.getTable("Table");
let rows = await table.findControls({ type: "Custom" });
await rows.map(async (row) => {
    let cells = await row.findControls({ type: "DataItem" });
    let price = await cells[2].value();
    if(parseInt(price) > 0) {
        let item = await cells[0].value();
        console.log(item, ":", price);
    }
});
table = model.getTable("Table")
rows = table.findControls({"type": "Custom"})

for row in rows:
    cells = row.findControls({"type": "DataItem"})
    price = cells[2].value()
    
    if int(price) > 0:
        item = cells[0].value()
        print(f"{item}: {price}")

结果如下：

image

在运行中会报一个warning，这是因为第一个行控件中不存在DataItem控件从而导致警告信息。
上述代码是先获取到全部的行控件，再对每一个行控件，拿到它所有的单元格控件，然后再通过索引访问中间需要的控件。比如已知价格Price列在第三列，因此索引值为2，而项目名Item列在第一列，因此索引值为0。通过这些索引值来取出相应的值。

总结

以上就是关于通过父控件来取得目标控件的方法。在目标控件没有明确标识符时，先获取它的父控件，再一层一层的往下解构直到获取到目标控件。除了应用在Qt的Table控件外，也可以应用在其它类似的组合控件中，如List、Tree等。

results matching ""

全部 API Walkthrough 其他

    No results matching ""