Qt 高频英文术语详解(扩充版:含出现位置 + 使用方式 + 实例)
原有分类与核心内容完整保留,每个术语补充「出现位置」「具体使用方式」,全部贴合 Qt Creator 可视化操作 + 代码开发的真实场景。
一、UI 设计器常见英文(属性栏 + 对象浏览器 + 右键菜单)
1. objectName
- 释义:对象名称,控件的唯一标识符
- 出现位置:
- Qt Creator 右侧「属性编辑器」最顶部;
- 右上角「对象浏览器」控件树里显示的名称;
- C++ 代码中 ui->xxx 的 xxx 部分;
- QSS 样式表 #控件名 选择器。
- 使用方式: 在属性栏双击修改,同一窗口内必须唯一,建议用英文 + 下划线命名(如 btn_start、label_temp),不能用中文、空格。代码通过 ui->objectName 访问控件,样式表通过 #objectName 精准指定样式。
- 实例:
// 代码中通过 objectName 操作按钮
ui->btn_start->setText("启动电机");/* QSS 中通过 # + objectName 单独设置样式 */
#btn_start { background-color: #2ecc71; }
2. text
- 释义:文本,控件表面显示给用户看的文字内容
- 出现位置:
- 属性栏 QAbstractButton / QLabel 分类下;
- 右键控件 →「改变文本」;
- 代码 setText() / text() 函数。
- 使用方式: 静态显示直接在属性栏输入;运行时动态变化用代码 setText() 修改。按钮、标签、复选框、单选框都有该属性。
- 实例:
// 动态修改标签显示的温度数值
ui->label_temp->setText("当前温度:25.6℃");
3. enabled
- 释义:启用状态,控制控件是否可交互
- 出现位置:
- 属性栏 QWidget 分类下的勾选框;
- 代码 setEnabled() / isEnabled();
- QSS 伪状态 :disabled。
- 使用方式: 勾选 = true 正常可用;取消勾选 = false 控件变灰,无法点击、无法输入。常用于权限控制、流程锁定(比如未登录时禁用操作按钮)。
- 实例:
// 电机运行时,禁用启动按钮
ui->btn_start->setEnabled(false);/* 禁用状态下按钮文字变浅灰 */
QPushButton:disabled { color: #aaaaaa; }
4. visible
- 释义:可见性,控制控件是否显示在界面上
- 出现位置:
- 属性栏 QWidget 分类下的勾选框;
- 代码 setVisible() / isVisible();
- 简写 show() / hide()。
- 使用方式: true 正常显示;false 完全隐藏,不占用界面位置。适合做页面切换、条件显示的控件。
- 实例:
// 报警触发时显示警告图标
ui->label_warn->setVisible(true);
5. geometry
- 释义:几何属性,包含控件的 x 坐标、y 坐标、宽度、高度
- 出现位置:
- 属性栏 QWidget → geometry 折叠项;
- UI 界面拖动控件、拖拽边角缩放时自动更新;
- 代码 setGeometry() / geometry()。
- 使用方式: 坐标原点在父容器左上角,x 向右增大,y 向下增大。固定布局界面用拖拽调整,动态界面用代码修改位置大小。
- 实例:
// 参数依次:x坐标, y坐标, 宽度, 高度
ui->widget_panel->setGeometry(50, 50, 300, 200);
6. size 系列(minimumSize /maximumSize/fixedSize)
- 释义:尺寸相关,控制控件宽高范围
- minimumSize:最小尺寸,窗口缩小时控件不会小于该值
- maximumSize:最大尺寸,窗口放大时控件不会大于该值
- fixedSize:固定尺寸,宽高锁定不可拉伸
- 出现位置:属性栏 QWidget 分类下;代码 setMinimumSize() 等。
- 使用方式: 配合布局使用,防止控件被压缩变形;图片控件建议设置最小尺寸,避免背景图被挤没。
- 实例:
// 限制按钮最小宽高,防止文字显示不全
ui->btn_ok->setMinimumSize(80, 32);
7. tooltip
- 释义:悬浮提示,鼠标停在控件上弹出的小字说明
- 出现位置:属性栏 QWidget 分类;代码 setToolTip()。
- 使用方式: 给图标按钮、复杂功能补充说明,用户鼠标悬停自动显示,不用占用界面空间。
- 实例:
ui->btn_alarm->setToolTip("点击查看历史报警记录");
8. focus
- 释义:焦点,代表当前正在操作的控件(如输入框光标闪烁)
- 出现位置:
- 代码 setFocus() / hasFocus();
- QSS 伪状态 :focus。
- 使用方式: 输入框、按钮获取焦点后可响应键盘操作;样式表里用 :focus 做高亮边框,提示用户当前操作位置。
- 实例:
/* 输入框获取焦点时边框变蓝 */
QLineEdit:focus { border: 2px solid #3498db; }
二、QSS 样式表英文(编辑样式表窗口 + 代码 setStyleSheet)
颜色、背景类
1. background 系列
-
background-color
- 释义:背景纯色
- 出现位置:样式表代码中;「添加颜色」按钮选色后可搭配该属性使用
- 使用方式:写在选择器内,设置控件底色,支持 rgb/rgba/ 十六进制 / 颜色名
- 实例:
QLabel { background-color: #f5f5f5; }
-
background-image
- 释义:背景图片(添加资源下拉第一项)
- 出现位置:编辑样式表 → 添加资源 → background-image,选图后自动生成代码
- 使用方式:给任意控件设置背景底图,必须搭配 background-repeat 控制平铺,否则默认重复铺满
- 实例:
#label_arrow {
background-image: url(:/resource/箭头(1).jpg);
background-repeat: no-repeat;
background-position: center;
background-size: contain;
}
-
transparent
- 释义:透明
- 出现位置:样式表颜色值位置;属性栏也可设置窗口透明属性
- 使用方式:替代具体颜色值,实现无底色、无边框效果;无边框窗口常用
- 实例:
/* 去掉按钮默认灰色底色 */
QPushButton { background-color: transparent; border: none; }
2. color
- 释义:文字颜色(极易和背景色混淆)
- 出现位置:样式表代码中;「添加字体」按钮选色后自动生成 color 属性
- 使用方式:只控制控件上的文字颜色,不影响背景;所有带文字的控件都支持
- 实例:
QPushButton { color: white; }
边框 border 系列
1. border
- 释义:边框简写属性,一次性设置粗细、线型、颜色
- 出现位置:样式表代码;可视化编辑器无直接按钮,需手动编写
- 使用方式:格式 border: 粗细 线型 颜色;,省略任意一项可能失效
- 实例:
QLineEdit { border: 1px solid #cccccc; }
2. solid / dashed / dotted
- 释义:边框线型
- solid:实线
- dashed:虚线
- dotted:点线
- 出现位置:border 属性的线型位置
- 使用方式:替换 solid 即可切换样式,输入框、面板常用实线,提示框可用虚线
3. border-radius
- 释义:圆角半径,数值越大角越圆
- 出现位置:样式表代码;手动编写
- 使用方式:单位 px;四个角可单独设置(border-top-left-radius)
- 实例:
QPushButton { border-radius: 6px; }
4. border-image
- 释义:边框贴图(九宫格拉伸,添加资源下拉第二项)
- 出现位置:编辑样式表 → 添加资源 → border-image,选图后自动生成基础代码
- 使用方式:专门做自适应边框皮肤,必须配合 border 宽度使用,四角不拉伸、中间自动拉伸;不能和 border-radius 同时用
- 实例:
#frame_skin {
border-image: url(:/resource/border_skin.png) 20 stretch;
border: 20px solid transparent;
}
图片控制类(对应添加资源三个选项)
1. image
- 释义:控件内置图标(添加资源下拉第三项)
- 出现位置:编辑样式表 → 添加资源 → image,选图后自动生成代码
- 使用方式:仅 QPushButton、QCheckBox、QRadioButton 等按钮类控件支持;图标和文字自动左右排版,不能铺满整个控件
- 实例:
#btn_alarm {
image: url(:/resource/alarm.png);
image-width: 24px;
padding-left: 8px;
}
2. position
- 释义:位置
- 出现位置:background-position 属性中
- 使用方式:控制背景图在控件内的对齐方式,常用值 center、left top、right bottom
3. repeat
- 释义:重复、平铺
- 出现位置:background-repeat 属性中
- 使用方式:
- no-repeat:只显示一张图(最常用)
- repeat-x:横向重复平铺
- repeat-y:纵向重复平铺
4. contain / cover
- 释义:背景图缩放模式
- contain:完整包含,等比例缩放直到整张图显示在控件内,不变形
- cover:全覆盖,等比例缩放直到填满控件,超出部分裁切
- 出现位置:background-size 属性值
- 使用方式:按钮图标、装饰图用 contain;全屏背景用 cover
字体 font 系列
1. font-family
- 释义:字体名称
- 出现位置:样式表代码;「添加字体」按钮选择字体后自动生成
- 使用方式:中文字体名必须加双引号;优先使用系统自带字体,避免用户电脑缺失
2. font-size
- 释义:字号大小
- 出现位置:样式表代码;添加字体窗口「大小」选项对应
- 使用方式:单位常用 px;全局统一字号建议在应用级别设置
3. font-weight
- 释义:字重(粗细)
- 出现位置:样式表代码;添加字体窗口「字形」选择粗体后自动生成
- 常用值:normal 常规、bold 粗体
4. italic
- 释义:斜体
- 出现位置:font-style 属性值;添加字体窗口选斜体后生成
内边距、外边距
1. padding
- 释义:内边距,控件边框与内部内容(文字 / 图片)的距离
- 出现位置:样式表代码;手动编写
- 使用方式:防止文字贴边显示不全;按钮增加内边距可扩大点击区域
- 实例:
QPushButton { padding: 6px 12px; }
2. margin
- 释义:外边距,控件外边缘与其他控件 / 容器边缘的距离
- 出现位置:样式表代码、布局属性中
- 使用方式:调整控件之间的间距,布局内控件常用 layout-margin 控制
控件状态伪选择器
1. hover
- 释义:鼠标悬浮状态
- 出现位置:选择器后加 :hover,手动编写
- 使用方式:鼠标移到控件上时切换样式,做悬停提示、按钮高亮
- 实例:
QPushButton:hover { background-color: #5dade2; }
2. pressed
- 释义:鼠标按下状态
- 出现位置:选择器后加 :pressed
- 使用方式:鼠标按住控件时的样式,模拟按压反馈
3. disabled
- 释义:禁用状态
- 出现位置:选择器后加 :disabled
- 使用方式:控件 setEnabled(false) 时自动生效,通常设为灰色降低视觉权重
4. checked
- 释义:选中状态
- 出现位置:选择器后加 :checked
- 使用方式:复选框、单选框、可勾选按钮选中时的样式
- 实例:
QCheckBox:checked { color: #27ae60; }
三、信号与槽 Signal & Slot(Qt 核心机制)
1. Signal 信号
- 释义:控件发生事件时向外发出的通知
- 出现位置:
- 右键控件 →「转到槽」弹出的信号列表;
- 信号槽编辑器界面;
- 代码 connect 函数第二个参数。
- 使用方式:无需手动调用,用户操作(点击、输入)触发后自动发出;常用信号:按钮 clicked()、输入框 textChanged()、窗口 closed()。
2. Slot 槽函数
- 释义:接收信号并执行具体逻辑的函数
- 出现位置:
- 右键「转到槽」自动生成到 .h 和 .cpp 中;
- 自定义 slots: 区块声明的函数。
- 使用方式:和普通函数写法一致,必须和信号绑定后才会被触发;业务逻辑都写在槽函数里。
3. connect
- 释义:连接函数,把「信号发送者 + 信号」绑定到「接收者 + 槽函数」
- 出现位置:通常写在窗口构造函数中;UI 转到槽会自动生成连接代码。
- 使用方式:标准格式 connect(发送者, 信号, 接收者, 槽函数),一个信号可以连多个槽,多个信号也可以连同一个槽。
- 实例:
// 点击启动按钮,触发 onStartClicked 函数
connect(ui->btn_start, &QPushButton::clicked, this, &Widget::onStartClicked);
4. emit
- 释义:发射,主动触发自定义信号
- 出现位置:自定义信号的触发处,写在 cpp 代码中。
- 使用方式:自定义信号前加 emit 关键字,手动触发信号,常用于跨窗口传值、状态通知。
- 实例:
// 温度超标时,主动发出报警信号
if(temp > 80) {
emit sig_alarm(temp);
}
四、资源与图片加载术语
1. Resource 资源
- 释义:打包进程序的图片、字体、配置文件等素材
- 出现位置:
- 左侧项目视图 Resources 文件夹;
- resource.qrc 资源配置文件;
- 编辑样式表「添加资源」弹出的资源选择窗口。
- 使用方式:通过 qrc 文件管理,编译后打包进 exe,无需额外携带图片文件;路径前缀固定为 :/。
2. pixmap(QPixmap)
- 释义:像素图类,面向界面显示的图片对象
- 出现位置:
- 代码 QPixmap 类、setPixmap() 函数;
- QLabel 属性栏 pixmap 选项可直接选图。
- 使用方式:专门用于界面渲染,底层优先存显存,显示速度快;适合按钮图标、界面配图。
- 实例:
// 给 Label 设置图片
ui->label_logo->setPixmap(QPixmap(":/resource/txlogo.bmp"));
3. image(QImage)
- 释义:图像类,面向像素处理的图片对象
- 出现位置:代码 QImage 类;样式表 image 属性是另一概念。
- 使用方式:存在 CPU 内存中,支持像素级修改、缩放、格式转换;需要处理图片时用 QImage,处理完转 QPixmap 显示。
4. dpi
- 释义:每英寸点数,打印分辨率参数
- 出现位置:图片属性详情、高 DPI 屏幕适配设置。
- 使用方式:屏幕显示只看像素尺寸,dpi 不影响清晰度;仅打印、导出图纸时生效。
5. scale / scaled
- 释义:缩放
- 出现位置:代码 scaled() 函数;样式表 background-size 本质也是缩放。
- 使用方式:大图片加载后先缩放再显示,大幅节省内存,避免界面卡顿。
- 实例:
QPixmap pix(":/resource/bg.jpg");
// 缩放到宽 1920,高度自动等比例
QPixmap smallPix = pix.scaledToWidth(1920, Qt::SmoothTransformation);
五、布局 Layout(界面自动排版)
1. Layout 布局
- 释义:自动管理控件位置和大小的排版容器
- 出现位置:
- 左侧控件栏「Layouts」分类;
- 工具栏布局快捷按钮;
- 右键控件 →「布局」子菜单。
- 分类与使用:
- QHBoxLayout(Horizontal 水平布局):控件横向排成一行;
- QVBoxLayout(Vertical 垂直布局):控件纵向排成一列;
- QGridLayout(Grid 网格布局):多行多列表格排列。
- 使用方式:选中多个控件 / 容器,点击工具栏对应布局按钮,自动适配窗口大小。
2. spacer 弹簧 / 占位符
- 释义:空白占位控件,用来撑开间距
- 出现位置:左侧控件栏「Spacers」分类,分 Horizontal Spacer 和 Vertical Spacer。
- 使用方式:拖到布局里,自动填充空白区域,实现控件靠边、居中对齐等效果。
3. stretch 拉伸系数
- 释义:布局内控件的空间分配比例
- 出现位置:布局属性 layoutStretch;代码 setStretch()。
- 使用方式:窗口放大时,按系数比例分配额外空间;比如 1:2 代表第二个控件分得两倍空间。
六、窗体与通用窗口单词
1. Widget
- 释义:基础控件类,所有可视化元素的父类
- 出现位置:新建工程默认基类 QWidget;所有控件都继承自 QWidget。
- 使用方式:既可作为独立窗口,也可作为容器放其他控件;属性栏里通用属性(size、enabled、styleSheet)都来自 QWidget。
2. Window
- 释义:顶层独立窗口,带标题栏、关闭按钮
- 出现位置:窗口标志 Qt::Window;代码 show() 以窗口形式显示。
3. Dialog 对话框
- 释义:弹窗式窗口,多用于交互确认、参数设置
- 出现位置:新建文件 → Qt Designer 界面类 → QDialog; 常用内置对话框:QMessageBox(消息框)、QFileDialog(文件选择框)。
- 使用方式:
- 模态(modal):弹出后阻塞父窗口,必须先处理弹窗;
- 非模态:弹出后仍可操作主窗口。
- 实例:
QMessageBox::information(this, "提示", "操作成功");
4. title 标题
- 释义:窗口标题栏文字
- 出现位置:属性栏 windowTitle;代码 `setWindowTitle ()。
- 实例:
this->setWindowTitle("温度监控系统");
5. icon 图标
- 释义:窗口标题栏图标、按钮图标
- 出现位置:属性栏 windowIcon、icon;代码 `setWindowIcon ()。
七、文件与工程常用单词
1. Header 头文件(.h)
- 释义:声明类、函数、变量的文件
- 出现位置:左侧项目视图「Headers」分类;
- 使用方式:写类定义、信号槽声明、函数原型,被 cpp 文件引用。
2. Source 源文件(.cpp)
- 释义:写具体实现代码的文件
- 出现位置:左侧项目视图「Sources」分类;
- 使用方式:包含对应头文件,实现所有声明的函数、业务逻辑。
3. UI File 界面文件(.ui)
- 释义:可视化设计的界面描述文件
- 出现位置:左侧项目视图「Forms」分类;如 widget.ui。
- 使用方式:双击打开 UI 设计器,拖拽控件排版;编译后自动生成 ui_widget.h 代码。
4. Build 构建 / 编译
- 释义:把代码编译成可执行程序的过程
- 出现位置:左下角锤子按钮;菜单栏「构建」。
- 使用方式:修改代码后必须构建才能运行;报错会在「编译输出」面板显示。
5. Debug 调试模式
- 释义:可断点调试的构建版本
- 出现位置:左下角构建套件切换;项目构建设置。
- 使用方式:开发阶段用,可打断点、看变量值、排查崩溃;程序体积大、运行慢。
6. Release 发布模式
- 释义:最终发布的优化版本
- 出现位置:同 Debug 切换处。
- 使用方式:交付给用户时用,编译器做了优化,体积小、运行快;不能断点调试。
八、布尔关键字(代码 + 属性栏高频出现)
1. true / false
- 释义:布尔值,真 / 假
- 出现位置:
- 代码所有布尔类型参数、返回值;
- 属性栏勾选框(勾选 = true,取消 = false)。
- 使用方式:表示开关、状态、判断结果;Qt 中 enabled、visible、checkable 等属性都是布尔类型。
2. nullptr
- 释义:空指针
- 出现位置:指针初始化、判空代码中。
- 使用方式:指针创建时初始化为空,使用前判空,避免野指针崩溃。
易混淆单词对比(高频踩坑)
color vs background-color
- color:只改文字颜色,出现位置:字体设置、文字样式;误用后果:想改背景色写成 color,只有文字变色。
- background-color:只改背景底色,出现位置:背景设置、面板美化。
padding vs margin
- padding:控件内部留白,出现位置:控件样式内;作用:让文字不贴边框。
- margin:控件外部间距,出现位置:布局、容器样式;作用:拉开控件之间的距离。
QPixmap vs QImage
- QPixmap:显存优先,出现位置:界面显示、setPixmap;用途:展示图片。
- QImage:CPU 内存,出现位置:图像处理、像素操作;用途:修改、缩放、转换图片。
visible vs enabled
- visible=false:控件直接消失,出现位置:显示隐藏控制;
- enabled=false:控件还在,但灰色不能点,出现位置:权限、流程控制。
image(QSS 属性) vs background-image
- image:按钮内置小图标,和文字并排,出现位置:添加资源第三项;QLabel 用了无效。
- background-image:任意控件全屏背景图,出现位置:添加资源第一项;最通用。




