python - 如何删除 QTreeWidgetItem

Question

有几个网页说可以通过delete或ingQTreeWidgetItem删除。QTreeWidget.clear但是我下面的代码示例似乎没有这样做。我做错什么了吗？

#!/usr/bin/python
import sys
from PySide.QtGui import QApplication, QWidget, QTreeWidget, QTreeWidgetItem
#from PyQt4.QtGui import QApplication, QWidget, QTreeWidget, QTreeWidgetItem # Result was the same with `PySide`
import time

class TreeWidgetItemChild(QTreeWidgetItem):
    def __init__(self):
        super(TreeWidgetItemChild, self).__init__()
        print 'TreeWidgetItemChild init'

    def __del__(self):
        print 'TreeWidgetItemChild del'

def test_QTree_clear_children():
    tree = QTreeWidget()
    tree.setHeaderLabel('funksoul')
    i = TreeWidgetItemChild()    
    tree.addTopLevelItem(i)    
    print 'Before clearing'
    #tree.clear()                  # Didn't call destructor (__del__)
    #tree.removeItemWidget (i, 0)  # Didn't call destructor
    #i.__del__()                   # Called destructor but it's called again afterward
    del i                          # Didn't call destructor
    time.sleep(1)
    print 'After clearing'

if __name__ == '__main__':
    app = QApplication(sys.argv)
    test_QTree_clear_children()

打印为：

TreeWidgetItemChild init
Before clearing
After clearing
TreeWidgetItemChild del

在我看来TreeWidgetItemChild，进程终止时会被删除，而不是我的任何删除操作。

Answer 1

Python 在内存管理/删除对象的意义上与 C++ 不同。Python 有一个垃圾收集器 (GC)，可以自动管理对象的销毁。当对象的引用计数达到零时，就会发生这种情况。

del i only means 'decrement the reference count by one'. It never results in a direct call to __del__. __del__ of an object is only called when reference count reaches to zero and is about to be garbage collected. (Although this is true for CPython, it's not guaranteed for every implementation. It depends on the GC implementation. So you should not rely on __del__ at all)

Keeping story short, the call time of __del__ is ambiguous. You should never call __del__ (or any other __foo__ special methods) directly. In fact, for the reasons above you should rather avoid the use of __del__ at all (usually).

Apart from that, there is another issue.

tree.removeItemWidget(i, 0)

This does not remove an item from QTreeWidget. As the name suggests, it removes a widget from an item, not the QTreeWidgetItem. It's counterpart to the setItemWidget method, not the addTopLevelItem method.

If you need to remove a specific item from the tree, you should use takeTopLevelItem.

tree.takeTopLevelItem(tree.indexOfTopLevelItem(i))

tree.clear() is fine. It will remove every top level item from the tree.

Answer 2

通过调用del i，您只是删除了引用，而不是它所引用的实际 C++ 对象（referent），而不是对象本身。

将您的功能更改TreeWidgetItemChild.__del__为：

def __del__(self):
    treeWidget = self.treeWidget()
    #removing the QTreeItemWidget object
    treeWidget.takeTopLevelItem(treeWidget.indexOfTopLevelItem(self))
    print 'TreeWidgetItemChild del'

Answer 3

As an epilogue to Avaris' excellent answer, let's flog an even more general-purpose approach applicable to all widgets and widget items (rather than merely top-level tree widget items). Is this supposed Shangri-La too good to be true?

To quoth the Mario: "Waaaa! Let's-a-go!"

Here We-A-Go

Specifically, if your project leverages:

• PySide2, import the shiboken2 module and pass each tree widget item to be deleted to the shiboken2.delete() function ala:

  # Well, isn't that nice. Thanks, Qt Company.
  from PySide2 import shiboken2
  
  # Add this item to this tree.
  tree = QTreeWidget()
  item = TreeWidgetItemChild()
  tree.addTopLevelItem(item)
  
  # Remove this item from this tree. We're done here, folks.
  shiboken2.delete(item)
  

• PyQt5, import the sip module and pass each tree widget item to be deleted to the sip.delete() function ala:

  # Well, isn't that not-quite-so-nice. You are now required to import any
  # arbitrary PyQt5 submodule *BEFORE* importing "sip". Hidden side effects are
  # shameful, of course, but we don't make the rules. We only enforce them. For
  # detailed discussion, see:
  #
  #     http://pyqt.sourceforge.net/Docs/PyQt5/incompatibilities.html#pyqt-v5-11
  #
  # If your project requires PyQt5 >= 5.11, the following compatibility hack may
  # be safely reduced to the following one-liner:
  #
  #     from PyQt5 import sip
  from PyQt5 import QtCore
  import sip
  
  # Add this item to this tree.
  tree = QTreeWidget()
  item = TreeWidgetItemChild()
  tree.addTopLevelItem(item)
  
  # Remove this item from this tree.
  sip.delete(item)
  

Nothing Could Possibly Go Wrong

Yes, this behaves as expected under all platforms and (PyQt5|PySide2) releases. The Python-specific sip.delete() and shiboken2.delete() methods are high-level wrappers around the underlying C++ delete operator – and operate exactly identically. In the case of QTreeWidgetItem instances, this reproduces the C++ behaviour of immediately removing the passed item from its parent tree.

Yes, it is both glorious and sketchy. Thanks to alexisdm's relevant answer elsewhere for the motivational impetus behind this overwrought answer. ^{Glory be to alexisdm.}

Answer 4

You're confusing tree items (i.e., tree nodes) with the widgets that a given item can contain.

The following example creates a QTreeWidget and adds two items to it: a top level item and a nested one. Removing the comments you can see how both of them are removed from the tree.

#!/usr/bin/env python
import sys
from PyQt4.QtGui import *

class MyMainWindow(QMainWindow):
    def __init__(self, parent=None):
        super(MyMainWindow, self).__init__(parent)
        self.tree = QTreeWidget(self)
        self.setCentralWidget(self.tree)
        self.tree.setHeaderLabel('funksoul')
        i = QTreeWidgetItem(self.tree, ['top level'])   
        self.tree.addTopLevelItem(i)
        j = QTreeWidgetItem(i ,['nested level'])
        #i.takeChild(0)
        #self.tree.takeTopLevelItem(0)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    ui = MyMainWindow()
    ui.show()
    sys.exit(app.exec_())

For removing both types of items from the tree you need the items index. If you have a reference to the item you want to remove you can get the corresponding index with the indexOfTopLevelItem and indexOfChild functions.