sync: from linuxdeepin/dtkgui

[deepin-ci-robot]

Synchronize source files from linuxdeepin/dtkgui.

Source-pull-request: linuxdeepin/dtkgui#297

[deepin-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: deepin-ci-robot

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• debian/deepin/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[deepin-ci-robot]

deepin pr auto review

代码审查意见：

1. 文档注释更新：

   • 在docs/util/ddciicon.zh_CN.dox文件中，@enum Dtk::Gui::DDciIcon::IconAttibute和@fn bool Dtk::Gui::DDciIcon::isSupportedAttribute(DDciIconMatchResult result, IconAttibute attr)中的IconAttibute应更正为IconAttribute，以保持一致性。

2. 枚举类型命名：

   • 在include/util/ddciicon.h文件中，enum IconAttibute应该更正为enum IconAttribute，以保持命名一致性。

3. 弃用宏的使用：

   • 在include/util/ddciicon.h文件中，D_DECL_DEPRECATED宏的使用可能需要确认其定义和用途，以确保弃用提示的正确性。

4. 类型别名使用：

   • 在include/util/ddciicon.h文件中，using IconAttribute = DDciIcon::IconAttibute;的使用是为了简化代码，但需要确保所有使用IconAttibute的地方都已经更新为IconAttribute。

5. 函数参数类型一致性：

   • 在src/util/ddciicon.cpp文件中，isSupportedAttribute函数的参数类型已经从IconAttibute更正为IconAttribute，这是一个好的做法，可以避免类型不匹配的问题。

6. 代码风格一致性：

   • 确保整个项目中使用的代码风格一致，包括命名约定、注释风格等。如果有项目特定的编码规范，应遵循这些规范。

7. 弃用警告：

   • 如果D_DECL_DEPRECATED宏用于标记IconAttibute枚举类型为已弃用，应确保在代码的其他部分有相应的警告提示，以提醒开发者不要使用已弃用的功能。

8. 代码注释：

   • 在src/util/ddciicon.cpp文件中，isSupportedAttribute函数的实现部分缺少注释，建议添加注释说明每个分支的逻辑和目的。

综上所述，代码的修改主要是为了保持命名的一致性和类型的安全性，同时确保代码的可读性和可维护性。建议在合并这些更改之前，进行全面的测试，以确保这些更改不会引入新的问题。