QFont类详细介绍

最新推荐文章于 2025-07-07 10:46:28 发布

原创最新推荐文章于 2025-07-07 10:46:28 发布 · 481 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#python #开发语言 #qt

PyQt5.QtGui 专栏收录该内容

15 篇文章

订阅专栏

QFont 类详解及常用方法

QFont 是 PyQt5 中用于定义文本字体样式的类，控制字体类型、大小、粗细、斜体、下划线等属性，广泛应用于控件（如 QLabel、QPushButton）和绘图（QPainter）中的文本渲染。以下是详细说明及常用方法：

一、核心功能

字体族（Font Family）：如 Arial、Times New Roman。
字号与单位：支持磅值（pointSize）和像素（pixelSize）。
字体样式：粗体、斜体、下划线、删除线。
字体缩放：自动适配控件缩放。
字体匹配：指定备选字体族（如 ["Arial", "微软雅黑"]）。

二、构造函数

构造函数	说明	示例
`QFont()`	默认字体（系统默认字体，12pt）	`font = QFont()`
`QFont(family: str, pointSize: int = -1, weight: int = -1, italic: bool = False)`	指定字体族、字号、粗细、斜体	`font = QFont("Arial", 14, QFont.Bold, True)`

三、常用方法

1. 字体基本属性

方法	说明	示例
`setFamily(family: str)`	设置字体族	`font.setFamily("微软雅黑")`
`family() -> str`	获取当前字体族	`current_family = font.family()`
`setPointSize(size: int)`	设置字号（磅值 `font.setPointSize(12)`
`pointSize() -> int`	获取当前磅值	`size = font.pointSize()`
`setPixelSize(size: int)`	设置字号（像素）	`font.setPixelSize(24)`
`pixelSize() -> int`	获取当前像素值	`px = font.pixelSize()`

2. 字体样式

方法	说明	示例
`setBold(enable: bool 设置粗体	`font.setBold(True)`
`bold() -> bool`	是否粗体	`is_bold = font.bold()`
`setItalic(enable: bool)`	设置斜体	`font.setItalic(True)`
`italic() -> bool`	是否斜体	`is_italic = font.italic()`
`setUnderline(enable: bool)`	设置下划线	`font.setUnderline(True)`
`underline() -> bool`	是否有下划线	`has_underline = font.underline()`
`setStrikeOut(enable: bool)`	设置删除线	`font.setStrikeOut(True)`
`strikeOut() -> bool`	是否有删除线	`has_strike = font.strikeOut()`

3. 其他设置

方法	说明	示例
`setWeight(weight: int)`	设置粗细（范围 0~1000，`QFont.Weight` 枚举值）	`font.setWeight(QFont.Bold)`
`weight() -> int`	获取当前粗细	`weight = font.weight()`
`setLetterSpacing(type: QFont.SpacingType, spacing: float)`	设置字母间距（`QFont.PercentageSpacing` 或 `AbsoluteSpacing`）	`font.setLetterSpacing(QFont.PercentageSpacing, 150)`
`setWordSpacing(spacing: float)`	设置单词间距（像素）	`font.setWordSpacing(5)`

4. 字体枚举值

属性	说明
`QFont.Thin`	细体（权重 100）
`QFont.Normal`	正常（400）
`QFont.Bold`	粗体（700）
`QFont.Black`	极粗（900）
`QFont.StyleNormal`	非斜体
`QFont.StyleItalic`	斜体

四、代码示例

1. 设置控件字体

python

from PyQt5.QtWidgets import QLabel, QApplication

label = QLabel("Hello World")
font = QFont("Arial", 14)  # 创建字体对象
font.setBold(True)
font.setUnderline(True)
label.setFont(font)        # 应用字体到控件

2. 在 QPainter 中绘制文本

python

from PyQt5.QtGui import QPainter, QFont

def paintEvent(self, event):
    painter = QPainter(self)
    font = QFont("Times New Roman", 18)
    font.setItalic(True)
    painter.setFont(font)
    painter.drawText(50, 50, "PyQt5 Text Rendering")

3. 获取系统字体列表

python

from PyQt5.QtGui import QFontDatabase

# 获取所有可用字体族
font_db = QFontDatabase()
fonts = font_db.families()
print("系统字体列表:", fonts[:5])  # 输出前5个字体

五、注意事项

字体可用性：
指定字体族时，需确保系统已安装该字体，否则会回退到默认字体。
解决方案：设置备选字体族列表：

python
```
font = QFont()
font.setFamilies(["Arial", "微软雅黑", "sans-serif"])
```
单位选择：
- setPointSize()：字号与屏幕分辨率无关，适合打印场景。
- setPixelSize()：字号固定为像素值，适合精确控制界面显示。
字体缩放：
设置 setPixelSize() 后，pointSize() 返回 -1，反之亦然。
性能优化：
频繁创建字体对象会影响性能，建议复用实例或使用全局字体设置。