PyQt（Python+Qt）学习随笔：树型部件QTreeWidget中的项编辑方法editTriggers、editItem和openPersistentEditor作用及对比分析

在树型部件QTreeWidget中，有三种方法触发进行项数据的编辑：editTriggers触发编辑、editItem触发编辑和openPersistentEditor打开持久编辑器。

1、editTriggers触发编辑

在《PyQt(Python+Qt)学习随笔：QAbstractItemView的editTriggers属性以及平台编辑键（platform edit key ）》介绍了QAbstractItemView可以通过设置editTriggers来触发编辑，而QTreeWidget是QAbstractItemView类派生的，继承了该属性，因此通过设置该属性为非NoEditTriggers的值即可触发编辑。

editTriggers可以在Qt Designer中设置，如图：

也可以调用setEditTriggers(EditTriggers triggers)来触发，关于EditTriggers 枚举类请参考PyQt(Python+Qt)学习随笔：QAbstractItemView的editTriggers属性以及平台编辑键（platform edit key ）》。

注意：

要使得editTriggers能触发编辑，必须将项设置为可编辑的，但老猿验证发现QTreeWidget的flags（）值默认为61，不能编辑（请参考《PyQt（Python+Qt）学习随笔：Model中项的标记flags取值及枚举类型Qt.ItemFlag》）。因此必须设置项为可编辑的，要能对项进行编辑必须使用setFlags设置项为可编辑。可以参考如下代码示例来设置：

item.setFlags(item.flags() | QtCore.Qt.ItemIsEditable)

2、editItem触发编辑

QTreeWidget提供了进行项编辑的方法editItem，调用语法如下：

editItem(QTreeWidgetItem item, int column = 0)

注意：

editItem方法生效必须设置项的标记flags为可编辑
editItem一次只能触发一个项指定的列进行编辑，一旦退出编辑状态（如改变焦点），除非再次调用editItem或设置editTriggers触发编辑或打开永久编辑器否则对应项不能再编辑
连续多次调用editItem，中间没有触发事件处理，则只有第一次调用生效，后续调用无效

3、openPersistentEditor打开持久编辑器

上面介绍editItem时说明了editItem只能触发一次编辑，可以说进入临时编辑状态，一旦退出编辑除非再通过相关方式触发编辑否则项不可再编辑。与此相对应，QTreeWidget还提供了一种一旦打开编辑状态就可以随时再次编辑，除非显示关闭编辑状态，这种方式就是打开持久编辑器。调用方法如下：

openPersistentEditor(QTreeWidgetItem item, int column = 0)

该方法没有返回值。

注意：

openPersistentEditor在在树型部件设置了editTriggers为NoEditTriggers时也有效
openPersistentEditor在在树型部件项的flags值设置为不能编辑情况下，也能触发项编辑，并且除非调用closePersistentEditor（）方法，否则对应项的对应列一直都能编辑

4、项编辑小结

树型部件中项的编辑方法包括editTriggers触发编辑、editItem触发编辑和openPersistentEditor打开持久编辑器，这三种方法：

editTriggers触发编辑、editItem触发编辑必须要求项的标记flags支持编辑，而openPersistentEditor对项标记没有要求
在所有项flags支持编辑的情况下，在树型部件设置了editTriggers为AllEditTriggers时，如果在触发编辑的事件中调用editItem，实际能编辑的项是editTriggers触发的项，editItem指定的项无法编辑。老猿分析这与editItem连续调用相同，只有先触发的才有效
editTriggers触发编辑、editItem触发编辑都是一次性的，一旦退出编辑状态除非再次触发，否则不能再进行编辑，但openPersistentEditor是持久编辑，可以随时进行编辑，除非调用closePersistentEditor（）方法关闭编辑状态

三种方法各有特色，关键是看在什么时候使用，editTriggers方式是使用方便，只需要树型部件中设置一次即可，而editItem和openPersistentEditor 必须按项的列指定，但可以方便控制数据不能随意修改。

老猿Python，跟老猿学Python!