Visindigo::Widgets::MultiLabel Class
class Visindigo::Widgets::MultiLabel一个包含标题、描述和图标的标签组件. 详情...
| 头文件： | #include <MultiLabel> |
| 自以下版本： | Visindigo 0.13.0 |
| 继承自： | Visindigo::Widgets::BorderFrame |
| 被继承： |
公开成员函数
(自 Visindigo 0.13.0 引入) | MultiLabel(QWidget *parent = nullptr) |
(自 Visindigo 0.13.0 引入) virtual | ~MultiLabel() |
(自 Visindigo 0.13.0 引入) void | addCustomWidget(QWidget *widget) |
(自 Visindigo 0.13.0 引入) QWidget * | getCustomWidget() |
(自 Visindigo 0.13.0 引入) QString | getDescription() |
(自 Visindigo 0.13.0 引入) QString | getPixmapPath() |
(自 Visindigo 0.13.0 引入) QString | getTitle() |
(自 Visindigo 0.13.0 引入) virtual void | resizeEvent(QResizeEvent *event) override |
(自 Visindigo 0.13.0 引入) void | setAlignment(Qt::Alignment align) |
(自 Visindigo 0.13.0 引入) void | setContentsMargins(int left, int top, int right, int bottom) |
(自 Visindigo 0.14.0 引入) void | setCustomWidgetOrientation(Qt::Orientation orientation) |
(自 Visindigo 0.13.0 引入) void | setDescription(const QString &str) |
(自 Visindigo 0.13.0 引入) void | setPixmapFixedWidth(int width) |
(自 Visindigo 0.13.0 引入) void | setPixmapPath(const QString &filePath) |
(自 Visindigo 0.13.0 引入) void | setSpacing(int spacing) |
(自 Visindigo 0.13.0 引入) void | setTitle(const QString &str) |
详细说明
这个类提供一个现代UI中特别常见的需求，即图标-标题-描述的组合展示。 它允许开发者轻松地创建一个包含图标、标题和描述的标签组件。如果有需要， 也可以通过addCustomWidget()方法添加一个自定义的子组件，以满足更复杂的布局需求。
成员函数文档
[since Visindigo 0.13.0] MultiLabel::MultiLabel(QWidget *parent = nullptr)
parent 父窗口
构造函数
这个function 从 Visindigo 0.13.0 开始支持。
[virtual noexcept, since Visindigo 0.13.0] MultiLabel::~MultiLabel()
析构函数
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::addCustomWidget(QWidget *widget)
widget 要添加的自定义子组件
添加一个自定义的子组件，位于标题和描述的右侧。
这个函数会接管设置组件的所有权。调用此函数后 不应再在外部保留该组件的指针。
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] QWidget *MultiLabel::getCustomWidget()
return 当前的自定义子组件，如果没有则返回nullptr。
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] QString MultiLabel::getDescription()
return 描述文本
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] QString MultiLabel::getPixmapPath()
return 图标路径
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] QString MultiLabel::getTitle()
return 标题文本
这个function 从 Visindigo 0.13.0 开始支持。
[override virtual, since Visindigo 0.13.0] void MultiLabel::resizeEvent(QResizeEvent *event)
event resize事件
由MultiLabel重载的resizeEvent函数，用于在组件大小发生改变时调整图标的高度以保持正方形。 如果继承此类并重写了resizeEvent函数，则必须显式调用此函数以保持图标的正确显示，否则图标可能会变形或布局可能会错乱。
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setAlignment(Qt::Alignment align)
align 要设置的对齐方式
设置文本对齐方式
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setContentsMargins(int left, int top, int right, int bottom)
left 左边距, top 上边距, right 右边距, bottom 下边距
设置内容边距
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.14.0] void MultiLabel::setCustomWidgetOrientation(Qt::Orientation orientation)
orientation 布局方向
设置自定义子组件的布局方向，默认为水平布局。
这个function 从 Visindigo 0.14.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setDescription(const QString &str)
str 要设置的描述文本
设置描述文本
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setPixmapFixedWidth(int width)
width 图标固定宽度，单位为像素
设置图标固定宽度（高度会自动调整以保持正方形）
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setPixmapPath(const QString &filePath)
filePath 图标文件路径，可以是相对路径或绝对路径，支持常见的图像格式如PNG、JPEG等。
设置图标路径
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setSpacing(int spacing)
spacing 组件间距
设置组件间距
这个function 从 Visindigo 0.13.0 开始支持。
[since Visindigo 0.13.0] void MultiLabel::setTitle(const QString &str)
str 要设置的标题文本
设置标题文本
这个function 从 Visindigo 0.13.0 开始支持。