桌面应用 / 系统课时

用 QLabel 显示文本和图片

用 QLabel 显示文本和图片

本篇介绍 Qt 中最常用的显示控件 QLabel,帮助开发者完成文本提示、状态展示和图片显示等基础界面需求。学习后可以根据内容类型选择合适的显示方式,并处理常见的对齐和缩放问题。

学习目标

  • 掌握 QLabel 显示普通文本、富文本和图片的方法
  • 理解标签对齐方式以及内容尺寸处理规则
  • 能够设计适合不同场景的静态信息展示区域

QLabel 的基本用途

QLabel 是 Qt 中用于显示非编辑内容的控件。它可以展示简单字符串,也可以渲染富文本、图片以及其他可视内容。

常见使用场景包括:

  • 窗口标题和说明文字
  • 表单字段提示
  • 图标和状态图片展示
  • 软件 Logo 或帮助信息显示

与输入控件不同,QLabel 默认只负责展示内容,不提供用户编辑能力。

显示文本内容

普通文本可以直接设置给 QLabel。文本内容较简单时,Qt 会按照标签当前字体和样式进行绘制。

cpp
#include <QApplication>
#include <QLabel>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QLabel label("Qt 6 Desktop App");
    label.show();

    return app.exec();
}

预期结果

text
窗口中显示文本:Qt 6 Desktop App

如果需要显示带格式的内容,可以让 QLabel 处理富文本,例如包含粗体、颜色或简单排版的 HTML 片段。

使用富文本时,需要注意内容来源是否可信,避免直接显示未经处理的用户输入。

显示图片和处理缩放

QLabel 可以通过 QPixmap 显示图片。图片显示效果受到标签尺寸、缩放策略和对齐方式影响。

cpp
QLabel label;
QPixmap image("logo.png");

label.setPixmap(image);
label.setAlignment(Qt::AlignCenter);
label.show();

预期结果

text
窗口中显示 logo.png 图片,图片位于 QLabel 中央位置

如果图片尺寸可能超过控件大小,可以在设置前根据 QLabel 尺寸进行缩放。例如图片预览窗口通常需要保持宽高比例缩放,而不是简单拉伸。

设置对齐方式

QLabel 的内容位置可以通过 alignment 属性控制。

常见设置包括:

设置 效果
Qt::AlignLeft 内容靠左
Qt::AlignCenter 内容居中
Qt::AlignRight 内容靠右
Qt::AlignTop 内容靠上

文字标签通常根据界面布局选择左对齐或居中,而图片展示区域通常使用居中对齐。

文本与图片显示的选择

QLabel 同时支持文字和图片,但一个标签通常承担一种主要职责。将大量动态内容、复杂交互内容放入 QLabel 会降低界面维护性。

实际开发中可以根据需求选择:

需求 推荐方式
静态说明文字 QLabel 文本
图标展示 QLabel + QPixmap
用户输入 QLineEdit 等输入控件
大量动态富内容 专用显示控件

合理使用 QLabel,可以让界面中的提示信息、状态信息和视觉元素保持清晰分工。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 QLabel 显示文本和图片

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通