如何在Qt QML的PdfMultiPageView中实现鼠标选中文本

要在PdfMultiPageView中实现文本选中功能，核心要解决输入事件拦截和视图坐标到文档坐标的转换两个问题，具体实现如下：

1. 拦截输入事件 #

PdfMultiPageView内部自带输入处理逻辑，会优先抢占鼠标事件。我们可以在视图上层添加一个透明的Item来接收鼠标拖动事件，避免和视图的输入逻辑冲突。

2. 坐标转换 #

PdfSelection需要使用PDF文档的逻辑坐标而非视图的像素坐标，通过PdfMultiPageView的mapToDocument()方法，可将视图坐标转换为文档坐标。

3. 定制页面委托绘制选中区域 #

直接全局绘制选中区域会出现位置偏移问题，需要通过pageDelegate为每个页面单独绘制对应区域的选中高亮。

完整代码示例 #

ApplicationWindow {
    id: root
    width: 800
    height: 1024
    color: "darkgrey"
    title: doc.title
    visible: true
    property string source // 从main.cpp传入PDF路径

    PdfMultiPageView {
        id: view
        anchors.fill: parent
        document: doc
        interactive: true

        // 定制页面委托，添加选中区域高亮
        pageDelegate: Rectangle {
            color: "transparent"
            border.color: "grey" // 可选：显示页面边框

            PdfPage {
                id: page
                anchors.fill: parent
                document: doc
                pageIndex: model.pageIndex
            }

            // 绘制当前页面的选中区域
            Shape {
                visible: selection.hold || textSelectionDrag.active
                anchors.fill: parent
                ShapePath {
                    fillColor: "rgba(0, 120, 215, 0.2)" // 选中区域背景色
                    strokeColor: "rgba(0, 120, 215, 0.8)" // 选中区域边框色
                    strokeWidth: 1
                    PathMultiline {
                        paths: selection.geometryForPage(model.pageIndex)
                    }
                }
            }
        }
    }

    PdfDocument {
        id: doc
        source: Qt.resolvedUrl(root.source)
    }

    PdfSelection {
        id: selection
        document: doc
        // 将视图坐标转换为文档坐标
        from: view.mapToDocument(textSelectionDrag.centroid.pressPosition)
        to: view.mapToDocument(textSelectionDrag.centroid.position)
        hold: !textSelectionDrag.active
    }

    // 覆盖在视图上层的透明Item，用于接收选中拖动事件
    Item {
        anchors.fill: view
        color: "transparent"
        visible: true

        DragHandler {
            id: textSelectionDrag
            acceptedDevices: PointerDevice.Mouse | PointerDevice.Stylus
            target: null
            grabPermissions: PointerHandler.TakeOverExisting // 接管输入事件
            onActiveChanged: {
                // 选中过程中禁用视图的滚动交互，避免冲突
                view.interactive = !active;
                selection.hold = !active;
            }
        }
    }
}

关键说明 #

• 输入拦截：上层透明Item的DragHandler优先接收鼠标拖动事件，通过grabPermissions: PointerHandler.TakeOverExisting确保接管输入，避免视图的滚动逻辑干扰选中操作。
• 坐标转换：view.mapToDocument()方法将视图的像素坐标转换为PDF文档的逻辑坐标，保证PdfSelection能正确定位文本区域。
• 选中区域绘制：通过pageDelegate为每个页面单独绘制选中区域，selection.geometryForPage(model.pageIndex)获取当前页面的选中路径，避免跨页面的位置偏移。

内容的提问来源于stack exchange，提问作者Vlad Ponomarev