如何让只读状态下的QTextEdit/QTextBrowser可点击MarkDown复选框

核心思路是避开setReadOnly(true)的全局限制，通过精准控制交互权限或事件拦截实现需求：

方案一：精准设置文本交互标志 #

无需设置setReadOnly(true)，直接组合交互标志，允许复选框点击和文本选择，但禁止编辑：

// 适用于QTextEdit/QTextBrowser
textEdit->setTextInteractionFlags(
    Qt::TextBrowserInteraction |  // 启用链接、复选框等富文本交互
    Qt::TextSelectableByMouse |   // 允许鼠标选中文本
    Qt::TextSelectableByKeyboard  // 允许键盘选中文本
);
// 额外禁用撤销/重做、自动换行（按需配置）
textEdit->setUndoRedoEnabled(false);
textEdit->setLineWrapMode(QTextEdit::NoWrap);

这种配置下，文本内容无法编辑，但Markdown渲染出的复选框可正常点击切换状态。

方案二：事件过滤器拦截编辑事件（强制只读场景） #

如果必须启用setReadOnly(true)，可以给控件安装事件过滤器，拦截编辑相关事件，同时放行复选框的点击操作：

// 自定义事件过滤器类
class ReadOnlyCheckboxFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *obj, QEvent *event) override
    {
        QTextEdit *edit = qobject_cast<QTextEdit*>(obj);
        if (!edit) return QObject::eventFilter(obj, event);

        // 拦截所有触发文本编辑的事件
        if (event->type() == QEvent::KeyPress ||
            event->type() == QEvent::MouseButtonDblClick ||
            event->type() == QEvent::InputMethod)
        {
            return true;
        }

        // 放行复选框区域的鼠标点击事件
        if (event->type() == QEvent::MouseButtonPress ||
            event->type() == QEvent::MouseButtonRelease)
        {
            QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);
            QTextCursor cursor = edit->cursorForPosition(mouseEvent->pos());
            QTextBlock block = cursor.block();
            // 判断当前文本块是否为Markdown复选框格式
            if (block.text().startsWith("- [ ]") || block.text().startsWith("- [x]"))
            {
                return false;
            }
            return true;
        }

        return QObject::eventFilter(obj, event);
    }
};

// 使用示例
ReadOnlyCheckboxFilter *filter = new ReadOnlyCheckboxFilter(this);
textEdit->setReadOnly(true);
textEdit->installEventFilter(filter);

补充说明 #

• QTextBrowser默认支持Markdown复选框交互，若设置了setReadOnly(true)，同样可通过上述事件过滤器方案恢复复选框点击功能。
• 确保使用Qt 5.14及以上版本，该版本对Markdown的复选框渲染和交互支持更完善。

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