PyQt5 QListWidget - 设置 Drop Indicator 属性

在 PyQt5 中，QListWidget 是一个非常有用的小部件，用于显示项目的列表。它还提供了一些属性和方法，可以自定义列表的外观和行为。

一个常见的需求是，当将项目拖放到 QListWidget 中时，希望显示一个指示器，以指示项目在列表中的放置位置。QListWidget 提供了 Drop Indicator 属性，可以用来设置和控制这个指示器。

设置 Drop Indicator 属性

要设置 Drop Indicator 属性，首先需要创建一个 QListWidget 对象：

list_widget = QListWidget()

然后，可以通过调用 setDragDropMode() 方法启用拖放功能，并将拖放模式设置为 QAbstractItemView.InternalMove：

list_widget.setDragDropMode(QAbstractItemView.InternalMove)

接下来，可以通过调用 setItemDelegate() 方法来设置一个自定义的 QAbstractItemDelegate 对象。在这个委托对象中，可以通过重写 paint() 方法来自定义 Drop Indicator 的外观：

class CustomItemDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        super().paint(painter, option, index)
        
        if option.state & QStyle.State_MouseOver:
            rect = option.rect
            painter.save()
            painter.setPen(Qt.red)
            painter.drawLine(rect.topLeft(), rect.topRight())
            painter.restore()

# 设置自定义委托
item_delegate = CustomItemDelegate()
list_widget.setItemDelegate(item_delegate)

在上面的示例中，当鼠标悬停在项目上方时，使用红色绘制了一条水平线作为 Drop Indicator。

通过上述步骤，可以成功设置 Drop Indicator 属性，使其在 QListWidget 中显示。

完整示例

from PyQt5.QtWidgets import QApplication, QListWidget, QAbstractItemView, QStyledItemDelegate
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStyle

class CustomItemDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        super().paint(painter, option, index)
        
        if option.state & QStyle.State_MouseOver:
            rect = option.rect
            painter.save()
            painter.setPen(Qt.red)
            painter.drawLine(rect.topLeft(), rect.topRight())
            painter.restore()

if __name__ == '__main__':
    app = QApplication([])
    
    # 创建 QListWidget
    list_widget = QListWidget()
    
    # 启用拖放功能和设置拖放模式
    list_widget.setDragDropMode(QAbstractItemView.InternalMove)
    
    # 设置自定义委托
    item_delegate = CustomItemDelegate()
    list_widget.setItemDelegate(item_delegate)
    
    # 添加项目
    list_widget.addItems(['Item 1', 'Item 2', 'Item 3'])
    
    list_widget.show()
    app.exec()

运行以上代码，将会显示一个 QListWidget，当将项目拖动到列表中时，会显示一个红色的水平指示器。

希望以上内容对你理解 PyQt5 QListWidget 的 Drop Indicator 属性有所帮助！