Qt Designer 自定义控件已提升后如何修改提升类含原理与踩坑实录环境Qt 5.12.10 / VS2017 / CMake 3.19场景已在 Designer 中将QWidget提升为CustomPanel现需改为MyCustomPanel关键词Qt提升(Promote)、自定义控件、修改提升类、Designer限制一、问题现象在 Qt Designer 的对象查看器中可以看到PanelBase的类名已经是自定义的CustomPanel不再是QWidget。现在需要把这个提升类从CustomPanel改成MyCustomPanel。直觉操作右键PanelBase→ 找提升为… →没有这个选项右键PanelBase→ “提升的窗口部件…” → 取消勾选CustomPanel勾选MyCustomPanel→提升按钮灰色点击无效关闭对话框一看 →PanelBase的类名还是CustomPanel毫无变化结论Qt Designer不提供切换已提升类的 UI 操作这是设计上的限制。二、踩坑分析三个试错的原因坑 1右键没有提升为…根本原因Designer 的右键菜单是状态敏感的——控件已提升后就不显示提升为…。控件当前状态右键菜单选项普通QWidget未提升有“提升为…”已提升为自定义类只有“提升的窗口部件…”坑 2提升的窗口部件对话框勾选无效根本原因该对话框的真实作用是管理注册表——告诉 Designer 这个.ui文件中有哪些自定义类可用。列表中的勾选只是控制该类是否出现在下拉列表中对已提升的控件不产生任何影响。坑 3提升按钮为什么是灰色的根本原因该对话框底部的提升按钮是用来**确认添加新注册的类**的配合下方新建提升的类区域使用。只有填写了新的类名和头文件后才会亮起。它不是用来把当前控件改成这个类的。三、两个对话框的本质区别对话框真实作用打开方式提升为…(Promote to…)提升当前控件把选中的QWidget变为某个自定义类右键普通控件提升的窗口部件…(Promoted Widgets)管理注册表管理本.ui中可用的自定义类列表右键已提升控件 / 菜单工具核心结论Designer 只支持首次提升和管理注册表不支持直接切换到另一个自定义类。如果是自定义界面的提升类 是没有取消提升这个选项的 如果是作为子控件是有取消提升这个选项如果是作为子控件 则有取消提升的选项如果要修改头文件 也需要再ui文件中修改linux大小写敏感会导致错误四、唯一正确方案直接修改 .ui 文件的 XML关闭 Designer用文本编辑器打开.ui文件修改两处第 1 处——修改控件的 class 属性搜索namePanelBase把classCustomPanel改成classMyCustomPanel!-- 修改前 --widgetclassCustomPanelnamePanelBasewidgetclassQWidgetnamebuttonLayout.../widget/widget!-- 修改后 --widgetclassMyCustomPanelnamePanelBasewidgetclassQWidgetnamebuttonLayout.../widget/widget注意namePanelBase不要动只改class属性。内部的子控件和布局完全保留不动。第 2 处——在 customwidgets 中注册新类在文件末尾找到customwidgets节点添加新类的声明旧类可保留也可删除不影响customwidgets!-- 旧类可以保留也可以删除 --customwidgetclassCustomPanel/classextendsQWidget/extendsheaderCustomPanel.h/headercontainer1/container/customwidget!-- 添加新类的声明 --customwidgetclassMyCustomPanel/classextendsQWidget/extendsheadermycustompanel.h/headercontainer1/container/customwidget/customwidgets保存后重新打开 Designer对象查看器中PanelBase的类名就会显示为MyCustomPanel。五、customwidget各属性节点详解customwidget有 4 个子节点每个都有明确作用1.class—— 自定义类的完整类名classMyCustomPanel/class说明要求自定义控件的 C 类名必须和代码中class MyCustomPanel完全一致大小写敏感必须和widget classxxx中的class属性匹配不匹配时uic编译报错示例如果这里写MyCustomPanel但class属性写了MyCustompanelp小写编译就会失败。2.extends—— 继承的 Qt 基础类extendsQWidget/extends说明要求该自定义类直接继承的 Qt 类必须和 Designer 中放置的基础控件类型一致常见对应关系Designer 中放的控件extends应该写QWidget从容器组拖的QWidgetQLabel从显示组件拖的QLabelQPushButton从按钮组拖的QPushButtonQFrameQFrameQGroupBoxQGroupBox⚠️ 如果放的是QLabel但extends写了QWidget编译会报错。因为uic生成的代码会用QLabel的构造函数创建对象然后尝试static_cast到你的自定义类如果继承链不对就会失败。3.header—— 头文件路径headermycustompanel.h/header说明要求uic生成ui_xxx.h时使用的#include路径必须能被编译器找到uic 生成的代码// ui_mainwindow.huic 自动生成#includemycustompanel.h// 就是由 header 决定的classUi_MainWindow{public:MyCustomPanel*PanelBase;// 由 widget classMyCustomPanel 决定类型...};路径规则如果头文件和.ui文件在同一目录直接写文件名mycustompanel.h如果在子目录写相对路径widgets/mycustompanel.h如果在项目 include 目录确保CMakeLists.txt或.pro中配置了include_directories4.container—— 容器标志container1/container值含义1该自定义控件可以作为容器Designer 允许往它内部拖放子控件0或不写该自定义控件不能作为容器Designer 不允许往它内部放子控件什么时候需要1自定义面板、自定义 Group、自定义容器类 → 写1你的PanelBase内部有buttonLayout、inputLayout等子控件 → 必须写1什么时候不需要自定义按钮、自定义仪表盘、自定义标签等纯显示/交互控件 → 可以写0或省略如果应该写1但没写Designer 中打开.ui文件时对象查看器里看不到该控件内部的子控件且无法往里面拖新控件。六、完整对照提升在 .ui 文件中的两处记录位置作用谁使用它widget classMyCustomPanel namePanelBase决定该控件在运行时的真实类型uic生成ui_xxx.h时声明MyCustomPanel *PanelBase;customwidget中的class在注册表中登记这个自定义类Designer 打开时识别为合法自定义类uic查找头文件customwidget中的extends告诉 Designer 和uic它继承自谁Designer 验证合法性uic生成正确的构造代码customwidget中的header告诉uic在哪里#includeuic生成#include mycustompanel.hcustomwidget中的container告诉 Designer 是否允许放子控件Designer 决定是否允许往里拖控件七、总结问题答案已提升的控件右键为什么没有提升为…菜单是状态敏感的已提升的控件不显示该选项提升的窗口部件对话框勾选为什么无效它只是管理注册表哪些类可用不修改具体控件提升按钮为什么是灰色的它是给新建提升的类用的确认按钮不是切换按钮正确做法是什么关闭 Designer直接改 .ui 文件的 XML一句话记住Qt Designer 能帮你首次提升和管理注册表但已提升后想换类唯一可靠的做法是直接改.ui文件的 XML——改widget的class属性 在customwidgets中注册新类。如果本文帮到了你欢迎点赞收藏如有疑问欢迎在评论区交流。
Qt Designer 自定义控件已提升后，如何修改提升类
Qt Designer 自定义控件已提升后如何修改提升类含原理与踩坑实录环境Qt 5.12.10 / VS2017 / CMake 3.19场景已在 Designer 中将QWidget提升为CustomPanel现需改为MyCustomPanel关键词Qt提升(Promote)、自定义控件、修改提升类、Designer限制一、问题现象在 Qt Designer 的对象查看器中可以看到PanelBase的类名已经是自定义的CustomPanel不再是QWidget。现在需要把这个提升类从CustomPanel改成MyCustomPanel。直觉操作右键PanelBase→ 找提升为… →没有这个选项右键PanelBase→ “提升的窗口部件…” → 取消勾选CustomPanel勾选MyCustomPanel→提升按钮灰色点击无效关闭对话框一看 →PanelBase的类名还是CustomPanel毫无变化结论Qt Designer不提供切换已提升类的 UI 操作这是设计上的限制。二、踩坑分析三个试错的原因坑 1右键没有提升为…根本原因Designer 的右键菜单是状态敏感的——控件已提升后就不显示提升为…。控件当前状态右键菜单选项普通QWidget未提升有“提升为…”已提升为自定义类只有“提升的窗口部件…”坑 2提升的窗口部件对话框勾选无效根本原因该对话框的真实作用是管理注册表——告诉 Designer 这个.ui文件中有哪些自定义类可用。列表中的勾选只是控制该类是否出现在下拉列表中对已提升的控件不产生任何影响。坑 3提升按钮为什么是灰色的根本原因该对话框底部的提升按钮是用来**确认添加新注册的类**的配合下方新建提升的类区域使用。只有填写了新的类名和头文件后才会亮起。它不是用来把当前控件改成这个类的。三、两个对话框的本质区别对话框真实作用打开方式提升为…(Promote to…)提升当前控件把选中的QWidget变为某个自定义类右键普通控件提升的窗口部件…(Promoted Widgets)管理注册表管理本.ui中可用的自定义类列表右键已提升控件 / 菜单工具核心结论Designer 只支持首次提升和管理注册表不支持直接切换到另一个自定义类。如果是自定义界面的提升类 是没有取消提升这个选项的 如果是作为子控件是有取消提升这个选项如果是作为子控件 则有取消提升的选项如果要修改头文件 也需要再ui文件中修改linux大小写敏感会导致错误四、唯一正确方案直接修改 .ui 文件的 XML关闭 Designer用文本编辑器打开.ui文件修改两处第 1 处——修改控件的 class 属性搜索namePanelBase把classCustomPanel改成classMyCustomPanel!-- 修改前 --widgetclassCustomPanelnamePanelBasewidgetclassQWidgetnamebuttonLayout.../widget/widget!-- 修改后 --widgetclassMyCustomPanelnamePanelBasewidgetclassQWidgetnamebuttonLayout.../widget/widget注意namePanelBase不要动只改class属性。内部的子控件和布局完全保留不动。第 2 处——在 customwidgets 中注册新类在文件末尾找到customwidgets节点添加新类的声明旧类可保留也可删除不影响customwidgets!-- 旧类可以保留也可以删除 --customwidgetclassCustomPanel/classextendsQWidget/extendsheaderCustomPanel.h/headercontainer1/container/customwidget!-- 添加新类的声明 --customwidgetclassMyCustomPanel/classextendsQWidget/extendsheadermycustompanel.h/headercontainer1/container/customwidget/customwidgets保存后重新打开 Designer对象查看器中PanelBase的类名就会显示为MyCustomPanel。五、customwidget各属性节点详解customwidget有 4 个子节点每个都有明确作用1.class—— 自定义类的完整类名classMyCustomPanel/class说明要求自定义控件的 C 类名必须和代码中class MyCustomPanel完全一致大小写敏感必须和widget classxxx中的class属性匹配不匹配时uic编译报错示例如果这里写MyCustomPanel但class属性写了MyCustompanelp小写编译就会失败。2.extends—— 继承的 Qt 基础类extendsQWidget/extends说明要求该自定义类直接继承的 Qt 类必须和 Designer 中放置的基础控件类型一致常见对应关系Designer 中放的控件extends应该写QWidget从容器组拖的QWidgetQLabel从显示组件拖的QLabelQPushButton从按钮组拖的QPushButtonQFrameQFrameQGroupBoxQGroupBox⚠️ 如果放的是QLabel但extends写了QWidget编译会报错。因为uic生成的代码会用QLabel的构造函数创建对象然后尝试static_cast到你的自定义类如果继承链不对就会失败。3.header—— 头文件路径headermycustompanel.h/header说明要求uic生成ui_xxx.h时使用的#include路径必须能被编译器找到uic 生成的代码// ui_mainwindow.huic 自动生成#includemycustompanel.h// 就是由 header 决定的classUi_MainWindow{public:MyCustomPanel*PanelBase;// 由 widget classMyCustomPanel 决定类型...};路径规则如果头文件和.ui文件在同一目录直接写文件名mycustompanel.h如果在子目录写相对路径widgets/mycustompanel.h如果在项目 include 目录确保CMakeLists.txt或.pro中配置了include_directories4.container—— 容器标志container1/container值含义1该自定义控件可以作为容器Designer 允许往它内部拖放子控件0或不写该自定义控件不能作为容器Designer 不允许往它内部放子控件什么时候需要1自定义面板、自定义 Group、自定义容器类 → 写1你的PanelBase内部有buttonLayout、inputLayout等子控件 → 必须写1什么时候不需要自定义按钮、自定义仪表盘、自定义标签等纯显示/交互控件 → 可以写0或省略如果应该写1但没写Designer 中打开.ui文件时对象查看器里看不到该控件内部的子控件且无法往里面拖新控件。六、完整对照提升在 .ui 文件中的两处记录位置作用谁使用它widget classMyCustomPanel namePanelBase决定该控件在运行时的真实类型uic生成ui_xxx.h时声明MyCustomPanel *PanelBase;customwidget中的class在注册表中登记这个自定义类Designer 打开时识别为合法自定义类uic查找头文件customwidget中的extends告诉 Designer 和uic它继承自谁Designer 验证合法性uic生成正确的构造代码customwidget中的header告诉uic在哪里#includeuic生成#include mycustompanel.hcustomwidget中的container告诉 Designer 是否允许放子控件Designer 决定是否允许往里拖控件七、总结问题答案已提升的控件右键为什么没有提升为…菜单是状态敏感的已提升的控件不显示该选项提升的窗口部件对话框勾选为什么无效它只是管理注册表哪些类可用不修改具体控件提升按钮为什么是灰色的它是给新建提升的类用的确认按钮不是切换按钮正确做法是什么关闭 Designer直接改 .ui 文件的 XML一句话记住Qt Designer 能帮你首次提升和管理注册表但已提升后想换类唯一可靠的做法是直接改.ui文件的 XML——改widget的class属性 在customwidgets中注册新类。如果本文帮到了你欢迎点赞收藏如有疑问欢迎在评论区交流。
