Python入坑系列-pyside6桌面编程之认识并设置理想字体效果_pyside6 css

Python入坑系列-pyside6桌面编程之认识并设置理想字体效果

通过本文章，可以掌握以下内容：

1. Pyside6 如何设置字体
2. QFont和部件自带字体有什么不同
3. 通过QSS如何控制字体样式
4. 设置字体一些常用技巧

1、Pyside6 字体介绍

在开发桌面程序时，尽量保持字体统一风格，保持最佳展示效果。

字体

Pyside6有他自己字体实现机制，主要通过QFont、QFontInfo、QFontMetrics、QFontMetricsF设置字体效果，但比使用html字体样式复杂的多，需要通过这些类的接口来查询和设置字体各种属性，最后由操作系统来渲染。字体匹配算法过程如下：

• 首先搜索指定的字体家族（通过setFamilies()设置）。
• 如果没有找到，将选择一个支持书写系统的替代字体。字体匹配算法将尝试找到最佳匹配所有在QFont中设置的属性。这个过程在不同的平台上有所不同。
• 如果系统上不存在可以支持文本的字体，那么将在其位置显示特殊的“缺失字符”框。

QFont

QFont类是用来处理字体的主要方式，可以指定字体的各种属性，如字体家族、大小、加粗、斜体等。Font不仅用于文本的显示，还可以用于图形界面中文本的绘制。代码示例如下：

from PySide6.QtGui import QFont
# 创建一个QFont对象
font = QFont()
# 设置字体家族
font.setFamily("Arial")
# 设置字体大小
font.setPointSize(10)
# 设置字体加粗
font.setBold(True)
# 设置字体斜体
font.setItalic(False)

常用方法

• setFamily(family): 设置字体家族。例如，font.setFamily("Arial")。
• setPointSize(size): 设置字体的点大小。例如，font.setPointSize(12)。
• setPixelSize(size): 设置字体的像素大小。这对于确保字体在不同分辨率的屏幕上具有一致的视觉大小很有用。
• setWeight(weight): 设置字体的粗细。QFont类提供了枚举值来表示不同的字体粗细，如QFont::Bold。
• setBold(bold): 设置字体是否加粗。传入True或False。
• setItalic(italic): 设置字体是否斜体。传入True或False。
• setUnderline(underline): 设置字体是否有下划线。传入True或False。
• setStrikeOut(strikeOut): 设置字体是否有删除线。传入True或False。

获取字体属性

• family(): 返回字体家族名称。
• pointSize(): 返回字体的点大小。
• pixelSize(): 返回字体的像素大小。
• weight(): 返回字体的粗细。
• bold(): 返回字体是否加粗。
• italic(): 返回字体是否斜体。
• underline(): 返回字体是否有下划线。
• strikeOut(): 返回字体是否有删除线。

QFontInfo

QFontInfo类在Qt中用于提供关于字体的详细信息。使用QFont对象设置了字体后，可能需要获取这个字体的一些实际使用的属性，比如实际的字体家族、字体大小、是否加粗等。运行示例：

from PySide6.QtGui import QFont, QFontInfo
font = QFont("Arial", 10)
fontInfo = QFontInfo(font)

创建了QFontInfo对象后，可以使用它来获取字体的各种信息：

• family(): 返回字体家族的名称。
• pointSize(): 返回字体的点大小。
• pixelSize(): 返回字体的像素大小。
• italic(): 返回字体是否为斜体。
• bold(): 返回字体是否加粗。
• weight(): 返回字体的权重。
• exactMatch(): 检查请求的字体设置是否与系统中的字体完全匹配。

QFontMetrics

QFontMetrics类在PySide6中用于提供关于字体的度量信息，如字体的高度、宽度、行距等。这些信息对于在图形用户界面(GUI)中进行精确的文本布局非常重要。QFontMetrics对象是基于QFont对象创建的，它反映了字体在特定设备上的渲染方式。示例代码如下：

from PySide6.QtGui import QFont, QFontMetrics
font = QFont("Arial", 10)
metrics = QFontMetrics(font)

常用方法：

• height(): 返回字体的高度（基线到基线的距离）。
• ascent(): 返回字体基线以上的最大高度。
• descent(): 返回字体基线以下的最大深度。
• leading(): 返回行间距（两行基线之间的距离减去字体高度）。
• lineSpacing(): 返回行距（基线到基线的距离，等于ascent + descent + leading）。
• averageCharWidth(): 返回字体中字符的平均宽度。
• maxWidth(): 返回字体中最宽字符的宽度。
• width(text): 返回给定文本字符串的宽度。在PySide6中，这个方法已经被horizontalAdvance(text)替代。
• horizontalAdvance(text): 返回给定文本字符串的水平进展宽度，即渲染文本所需的像素宽度。

QFontMetricsF

QFontMetricsF类在PySide6中提供了一种方式来获取关于字体的度量信息，与QFontMetrics类似，但它提供了浮点数精度的度量值。这使得QFontMetricsF在需要高精度布局时特别有用，比如在绘图应用或者需要精确控制文本布局的场景中。QFontMetricsF对象是基于QFont对象创建的。需要先有一个QFont对象，然后使用这个QFont对象来创建一个QFontMetricsF对象，代码示例如下：

from PySide6.QtGui import QFont, QFontMetricsF
font = QFont("Arial", 10)
metricsF = QFontMetricsF(font)

常用方法：

• ascent(): 返回字体基线以上的最大高度（浮点数）。
• descent(): 返回字体基线以下的最大深度（浮点数）。
• height(): 返回字体的高度，即基线到基线的距离（浮点数）。
• leading(): 返回行间距，即两行文本基线之间的距离减去字体高度（浮点数）。
• lineSpacing(): 返回行距，即基线到基线的距离，包括行间距（浮点数）。
• averageCharWidth(): 返回字体中字符的平均宽度（浮点数）。
• maxWidth(): 返回字体中最宽字符的宽度（浮点数）。
• horizontalAdvance(text): 返回给定文本字符串的水平进展宽度，即渲染文本所需的像素宽度（浮点数）

QFont和部件自带字体对比

在PySide6（和整个Qt框架）中，每个窗口小部件（Widget）都有一个自带的字体，这个字体是从其父窗口小部件继承而来的，最终追溯到应用程序的全局字体设置。QFont对象则是用来描述字体的各种属性的，比如字体家族（如Arial、Courier等）、大小、加粗、斜体等。当创建一个窗口小部件时，它会自动使用当前Qt应用程序的默认字体设置。如果没有特别指定一个字体，那么它就会使用这个默认字体。可以通过修改小部件的QFont来改变其显示文本的字体样式。这实际上是通过调用小部件的setFont()方法并传递一个QFont对象来实现的。这里的关系是：QFont是一个工具，用于定义字体的具体样式；而小部件的字体属性，则是实际应用这些样式的地方。通过改变小部件的QFont，可以控制其文本显示的具体外观。

以下是修改全局字体样式示例代码：

QFont和部件自带字体对比

Qss字体样式

QSS提供了一种类似于CSS的方式来设置应用程序的样式，包括字体。这种方法更加灵活，可以在不修改Python代码的情况下调整样式。示例代码：

from PySide6.QtWidgets import QApplication, QLabel
if __name__ == '__main__':
    app = QApplication([])
    # 创建标签
    label = QLabel("Hello, PySide6 with QSS!")
    # 使用QSS设置字体样式
    label.setStyleSheet("""
        QLabel {
            font-family: Arial;
            font-size: 10pt;
            font-weight: bold;
        }
    """)
    label.setMinimumSize(400,300)
    label.show()
    app.exec()

选择使用QFont还是QSS：

• 编程控制 vs. 样式表：如果希望在代码中直接控制字体样式，或者需要根据某些逻辑动态改变字体样式，使用QFont会更合适。如果倾向于分离样式和逻辑，或者希望能够轻松地调整应用程序的外观而不触碰Python代码，QSS将是更好的选择。
• 应用范围：QFont设置的字体样式仅适用于单个控件或通过代码显式设置的控件集。而QSS可以通过选择器应用于整个应用程序或特定类型的控件，使得统一设置样式变得更加容易

2、字体一些常用技巧

字号统一

保持主标题、标题、小标题、正文、正文（小），辅助文字，部件字体大小统一，会让界面开重点突出，整洁，清晰

QFont方法与Qss样式名称对应关系

StyleHint枚举值

StyleHint是QFont类中的一个枚举，用于指导字体匹配算法选择合适的默认字体家族，当指定的字体家族不可用时。这些样式提示帮助Qt选择一个视觉上接近用户需求的字体

HintingPreference枚举

可以应用于字形的不同级别的微调，以改善在像素密度可能需要时显示器上的可读性

Weight枚举

Qt使用一个从1到1000的权重刻度，与OpenType兼容。权重为1将是细薄的，而1000将是极黑的

Style枚举

用于显示文本的不同字形风格

Stretch枚举

预定义的拉伸值遵循CSS命名约定。值越高，文本拉伸得越多

Capitalization枚举

用于文本的渲染选项

SpacingType

用于控制字间距和行间距