当前位置：首页 > news >正文

QT控件命名简写

news 2025/7/14 14:10:27

在企业开发中，为提高代码可读性和团队协作效率，控件命名需遵循简洁性、一致性原则。基于您提供的Qt控件截图，以下是控件类型全称与推荐简写对照表，涵盖布局、容器、输入、显示四类控件：

一、布局控件（Layouts）

控件全称	推荐简写	示例
Vertical Layout	`vlay`	`vlayMain`
Horizontal Layout	`hlay`	`hlayToolbar`
Grid Layout	`glay`	`glayForm`
Form Layout	`flay`	`flaySettings`
Horizontal Spacer	`hsp`	`hspLeft`
Vertical Spacer	`vsp`	`vspBottom`

二、容器控件（Containers）

控件全称	推荐简写	示例
Group Box	`gbx`	`gbxUserInfo`
Scroll Area	`sa`	`saContent`
Tool Box	`tbox`	`tboxTools`
Tab Widget	`tab`	`tabMain`
Stacked Widget	`sw`	`swPages`
Frame	`frm`	`frmBorder`
Widget	`wgt`	`wgtCustom`
MDI Area	`mdi`	`mdiWorkspace`
Dock Widget	`dw`	`dwSidebar`
QAxWidget (ActiveX)	`ax`	`axExcel`

三、输入控件（Input Widgets）

控件全称	推荐简写	示例
Combo Box	`cb`	`cbLanguage`
Font Combo Box	`fcb`	`fcbTitle`
Line Edit	`le`	`leUsername`
Text Edit	`te`	`teDescription`
Plain Text Edit	`pte`	`pteNotes`
Spin Box	`sb`	`sbQuantity`
Double Spin Box	`dsb`	`dsbPrice`
Time Edit	`te`	`teStartTime`
Date Edit	`de`	`deBirthday`
Date/Time Edit	`dte`	`dteCreated`
Dial	`dial`	`dialVolume`
Horizontal Scroll Bar	`hsb`	`hsbImage`
Vertical Scroll Bar	`vsb`	`vsbLog`
Horizontal Slider	`hsl`	`hslBrightness`
Vertical Slider	`vsl`	`vslOpacity`
Key Sequence Edit	`kse`	`kseShortcut`

四、显示控件（Display Widgets）

控件全称	推荐简写	示例
Label	`lbl`	`lblStatus`
Text Browser	`tb`	`tbHelp`
Graphics View	`gv`	`gvCanvas`
Calendar Widget	`cal`	`calSchedule`
LCD Number	`lcd`	`lcdTimer`
Progress Bar	`prog`	`progLoad`
Horizontal Line	`hline`	`hlineDivider`
Vertical Line	`vline`	`vlineSeparator`
OpenGL Widget	`gl`	`glRender`
QQuickWidget (QtQuick)	`qw`	`qwDashboard`

五、按钮控件（Buttons）

控件全称	推荐简写	示例
Push Button	`btn`	`btnSubmit`
Tool Button	`tbtn`	`tbtnSave`
Radio Button	`rbtn`	`rbtnOptionA`
Check Box	`chk`	`chkAgree`
Command Link Button	`clbtn`	`clbtnNext`
Dialog Button Box	`dbb`	`dbbConfirm`

六、项视图控件（Item Views/Widgets）

控件全称	推荐简写	示例
List View	`lv`	`lvFiles`
Tree View	`tv`	`tvDirectory`
Table View	`tblv`	`tblvData`
List Widget	`lw`	`lwItems`
Tree Widget	`tw`	`twHierarchy`
Table Widget	`tblw`	`tblwResults`

七、命名规范总结

前缀规则：

- 控件类型简写 + 驼峰命名（如 btnSubmit、lblUserName）。

避免歧义：

- Text Edit → te（输入类） vs. Text Browser → tb（显示类）

项目统一：

- 团队提前约定简写表，禁止混用 btn/bt、cb/cmb。

特殊保留：

- QQuickWidget 简写 qw，区别于普通 Widget（wgt）。

代码示例对比

// 不推荐：无规范缩写 ✘
QPushButton *pushButton = new QPushButton("OK");// 推荐：统一缩写 ✔
QPushButton *btnOK = new QPushButton("OK");
QLineEdit *leUsername = new QLineEdit();
QGridLayout *glayForm = new QGridLayout();

⚠️ 注意：简写仅用于变量命名，UI文件（如XML）中仍建议保留全称以保证可读性。

查看全文

http://www.lryc.cn/news/587293.html