自定义QLabel子类在.ui文件中使用buddy功能生成错误代码

问题现象 #

使用Qt 5.15.2时，自定义QLabel派生类ItemLabel后，在.ui文件中设置其buddy属性，UIC生成的代码错误地将buddy控件名称以字符串形式传入setBuddy，而非控件指针：

item->setBuddy("icon"); // 错误生成的代码

而预期正确代码应为：

item->setBuddy(icon); // 正确代码

根本原因 #

.ui文件中自定义组件的<class>标签内容与实际类名大小写不匹配：
.ui里的定义是：

<class>Itemlabel</class> <!-- 此处为小写l -->

而实际类名是ItemLabel（大写L）。UIC因类名匹配失败，未识别出ItemLabel是QLabel的派生类，因此未按照QLabel的buddy属性逻辑生成代码，而是将其当作普通字符串属性处理。

解决步骤 #

1. 修正.ui文件中的自定义组件类名
   将<customwidget>里的<class>值改为与实际类名完全一致的ItemLabel：

<customwidgets>
 <customwidget>
  <class>ItemLabel</class> <!-- 修正为大写L -->
  <extends>QLabel</extends>
  <header>ui/widget/ItemLabel.h</header>
 </customwidget>
</customwidgets>

2. 重新生成UI代码
   执行UIC工具重新编译.ui文件，此时生成的setBuddy代码会正确传入控件指针：

item->setBuddy(icon);

额外验证（可选） #

如果修改后仍有问题，可以在ItemLabel类中显式声明继承自QLabel的setBuddy方法，帮助UIC识别该属性的正确类型：

class ItemLabel : public QLabel
{
    Q_OBJECT // 需添加Q_OBJECT宏以支持元对象系统
public:
    using QLabel::setBuddy; // 显式引入基类方法
    // ... 其他已有代码
};

注：修改类代码后需重新运行qmake，确保元对象编译正常。

内容的提问来源于stack exchange，提问作者pythonator