PySide6 GUI 学习笔记——常用类及控件使用方法（多行文本控件QTextEdit）

news2025/6/12 8:37:34

文章目录

PySide6.QtWidgets.QTextEdit 应用举例
- 概述
- 核心特性
- 常用方法
- - 文本内容操作
  - 光标和选择操作
  - 格式和样式
  - 查找功能
  - 视图控制
  - 状态设置
  - 常用信号
- 代码示例
- 示例说明
- - 1. 基本设置
  - 2. 文本格式化功能
  - 3. 功能按钮
  - 4. 信号处理

PySide6.QtWidgets.QTextEdit 应用举例

概述

QTextEdit 是 PySide6 中用于编辑和显示纯文本和富文本的控件。它提供了强大的文本处理能力，支持 HTML 样式标签和 Markdown 格式，能够处理大型文档并快速响应用户输入。

核心特性

支持纯文本和富文本（HTML 4 子集）编辑
Markdown 格式支持
自动换行和格式控制
撤销/重做功能
查找替换功能
自定义拖放操作
多种编辑和只读模式键盘快捷键

常用方法

文本内容操作

方法	描述
`setPlainText(text: str)`	设置纯文本内容
`toPlainText() -> str`	获取纯文本内容
`setHtml(html: str)`	设置 HTML 内容
`toHtml() -> str`	获取 HTML 内容
`setMarkdown(markdown: str)`	设置 Markdown 内容
`toMarkdown() -> str`	获取 Markdown 内容
`clear()`	清空所有内容
`append(text: str)`	在文档末尾追加新段落

光标和选择操作

方法	描述
`textCursor() -> QTextCursor`	获取当前光标
`setTextCursor(QTextCursor)`	设置当前光标
`cursorForPosition(QPoint) -> QTextCursor`	获取指定位置的光标
`cursorRect() -> QRect`	获取光标矩形区域
`selectAll()`	全选所有文本
`copy()`	复制选中内容
`cut()`	剪切选中内容
`paste()`	粘贴内容

格式和样式

方法	描述
`setAlignment(Qt.Alignment)`	设置段落对齐方式
`setFontFamily(family: str)`	设置字体族
`setFontPointSize(size: float)`	设置字体大小（磅值）
`setFontWeight(weight: int)`	设置字体粗细
`setFontItalic(italic: bool)`	设置斜体
`setFontUnderline(underline: bool)`	设置下划线
`mergeCurrentCharFormat(QTextCharFormat)`	合并当前字符格式

查找功能

方法	描述
`find(pattern: str, options: QTextDocument.FindFlags) -> bool`	查找文本模式

视图控制

方法	描述
`ensureCursorVisible()`	确保光标可见
`scrollToAnchor(name: str)`	滚动到指定锚点

状态设置

方法	描述
`setReadOnly(ro: bool)`	设置只读模式
`setPlaceholderText(text: str)`	设置占位文本
`setLineWrapMode(mode: QTextEdit.LineWrapMode)`	设置换行模式
`setLineWrapColumnOrWidth(width: int)`	设置换行宽度/列数

常用信号

信号	描述
`textChanged()`	文本内容改变时触发
`cursorPositionChanged()`	光标位置改变时触发
`selectionChanged()`	选择区域改变时触发
`copyAvailable(bool)`	复制可用状态改变时触发
`redoAvailable(bool)`	重做可用状态改变时触发
`undoAvailable(bool)`	撤销可用状态改变时触发

代码示例

import sys
from PySide6.QtWidgets import (
    QApplication, QMainWindow, QTextEdit, 
    QVBoxLayout, QWidget, QPushButton
)
from PySide6.QtGui import QTextCharFormat, QFont, QColor
from PySide6.QtCore import Qt

class TextEditorDemo(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QTextEdit 示例")
        self.setGeometry(100, 100, 800, 600)
        
        # 创建主控件和布局
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout(central_widget)
        
        # 创建文本编辑器
        self.text_edit = QTextEdit()
        self.text_edit.setPlaceholderText("在此输入内容...")
        self.text_edit.setLineWrapMode(QTextEdit.WidgetWidth)
        layout.addWidget(self.text_edit, 1)
        
        # 创建按钮面板
        button_layout = self.create_button_panel()
        layout.addLayout(button_layout)
        
        # 连接信号
        self.text_edit.textChanged.connect(self.on_text_changed)
        self.text_edit.cursorPositionChanged.connect(self.on_cursor_moved)
    
    def create_button_panel(self):
        from PySide6.QtWidgets import QHBoxLayout
        
        button_layout = QHBoxLayout()
        
        # 格式按钮
        btn_bold = QPushButton("粗体")
        btn_bold.clicked.connect(self.toggle_bold)
        button_layout.addWidget(btn_bold)
        
        btn_italic = QPushButton("斜体")
        btn_italic.clicked.connect(self.toggle_italic)
        button_layout.addWidget(btn_italic)
        
        btn_color = QPushButton("颜色")
        btn_color.clicked.connect(self.change_color)
        button_layout.addWidget(btn_color)
        
        # 功能按钮
        btn_clear = QPushButton("清空")
        btn_clear.clicked.connect(self.text_edit.clear)
        button_layout.addWidget(btn_clear)
        
        btn_html = QPushButton("获取HTML")
        btn_html.clicked.connect(self.print_html)
        button_layout.addWidget(btn_html)
        
        return button_layout
    
    def toggle_bold(self):
        fmt = QTextCharFormat()
        fmt.setFontWeight(QFont.Bold if not self.text_edit.fontWeight() > QFont.Normal else QFont.Normal)
        self.text_edit.mergeCurrentCharFormat(fmt)
    
    def toggle_italic(self):
        fmt = QTextCharFormat()
        fmt.setFontItalic(not self.text_edit.fontItalic())
        self.text_edit.mergeCurrentCharFormat(fmt)
    
    def change_color(self):
        fmt = QTextCharFormat()
        fmt.setForeground(QColor("blue"))
        self.text_edit.mergeCurrentCharFormat(fmt)
    
    def on_text_changed(self):
        print("文本内容已更改")
    
    def on_cursor_moved(self):
        print(f"光标位置: {self.text_edit.textCursor().position()}")
    
    def print_html(self):
        html = self.text_edit.toHtml()
        print("HTML内容:")
        print(html[:200] + "..." if len(html) > 200 else html)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = TextEditorDemo()
    window.show()
    sys.exit(app.exec())