如何移除/隐藏QTextEdit文本框架开头的多余文本块/行？

QTextEdit的文档默认包含一个根框架，根框架初始会自带一个空文本块。直接插入新框架时，这个空文本块会保留在框架外部，导致出现你看到的多余内容。以下两种方案可以解决这个问题：

方案1：清空默认内容后插入自定义框架 #

先删除文档默认的空文本块，再插入框架，确保框架成为根框架的唯一子元素：

from PySide6.QtGui import QTextFrameFormat, QTextCursor
from PySide6.QtWidgets import QApplication, QTextEdit

app = QApplication()
text_edit = QTextEdit()

# 定义框架格式
frame_format = QTextFrameFormat()
frame_format.setBorder(4)

cursor = text_edit.textCursor()
# 全选并删除文档默认内容，清除初始空文本块
cursor.select(QTextCursor.Document)
cursor.removeSelectedText()

# 插入自定义框架
cursor.insertFrame(frame_format)

# 在框架内部插入内容（光标自动处于框架内）
cursor.insertText("框架内的内容")

text_edit.show()
app.exec()

方案2：直接修改根框架格式（适合全局边框需求） #

如果你的需求是让整个编辑区域带边框，无需嵌套框架，直接修改根框架的格式更高效：

from PySide6.QtGui import QTextFrameFormat
from PySide6.QtWidgets import QApplication, QTextEdit

app = QApplication()
text_edit = QTextEdit()

# 获取文档根框架并设置格式
root_frame = text_edit.document().rootFrame()
frame_format = QTextFrameFormat()
frame_format.setBorder(4)
root_frame.setFrameFormat(frame_format)

# 直接在根框架内添加内容
text_edit.insertPlainText("整个编辑区域带边框")

text_edit.show()
app.exec()

关键说明 #

• 方案1适用于需要在文档中插入独立嵌套框架的场景，确保框架外无多余文本块。
• 方案2更适合全局样式需求，避免了额外框架的嵌套，从根源上消除多余文本块问题。

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