ARibbonGalleryGroup类是SARibbonGallery内部的一个组件,它表示一个类别活动,包含一组QAction动作列表,用于向SARibbonGallery添加类别活动。使用addCategoryActions函数创建一个SARibbonGalleryGroup,并将其添加到SARibbonGallery中。
常用的SARibbonGalleryGroup类函数:
SARibbonGalleryGroup(const QString& title, const QList<QAction*>& actions):构造函数,创建一个SARibbonGalleryGroup并添加QAction列表。
QString title() const:获取类别活动的标题。
void setTitle(const QString& title):设置类别活动的标题。
int actionCount() const:获取该类别活动的action数量。
void addAction(QAction* action):向类别活动添加一个QAction。
QAction* insertAction(QAction* before, QAction* action):将一个QAction插入到该类别活动中,并在指定的QAction之前。
QAction* removeAction(QAction* action):从该类别活动中移除一个QAction。
void clearActions():从该类别活动中移除所有QAction动作。
void setActionVisible(QAction* action, bool visible):设置QAction的可见性。
bool isActionVisible(QAction* action) const:获取QAction的可见性。
int columnCount() const:获取该类别活动的列数。
void setColumnCount(int column):设置该类别活动的列数。
int rowCount() const:获取该类别活动的行数。
void setRowCount(int row):设置该类别活动的行数。
void setGalleryGroupStyle(SARibbonGalleryGroup::GalleryGroupStyle style):设置该类别活动的显示样式。
SARibbonGalleryGroup::GalleryGroupStyle galleryGroupStyle() const:获取该类别活动的显示样式。
QList<QAction*> actions() const:获取该类别活动的所有QAction列表。
void setLeftActionVisible(bool visible):设置左侧菜单按钮的可见性。
bool isLeftActionVisible() const:获取左侧菜单按钮的可见性。
void setToolTip(const QString& tip):设置该类别活动的工具提示。
QString tooltip() const:获取该类别活动的工具提示。
void setGalleryGroupMargins(int left, int top, int right, int bottom):设置此类别活动内各个元素之间的边距。
void setGalleryItemSizePolicy(QSizePolicy::Policy policy):设置内置元素的大小策略。
QSizePolicy::Policy galleryItemSizePolicy() const:获取内置元素的大小策略。
void setGalleryItemTextVisible(bool visible):设置内置元素的文本可见性。
bool isGalleryItemTextVisible() const:获取内置元素的文本可见性。
void setGalleryItemIconVisible(bool visible):设置内置元素的图标可见性。
bool isGalleryItemIconVisible() const:获取内置元素的图标可见性。
void setGalleryItemCheckable(bool checkable):设置内置元素是否可选中。
bool isGalleryItemCheckable() const:获取内置元素是否可选中。
void setGridMinimumWidth(int width):设置类别活动网格视图每个项的最小宽度。
在SARibbonGallery内部,可以使用多个SARibbonGalleryGroup来组织和显示QAction列表。每个SARibbonGalleryGroup都有自己的标题、QAction列表和其他提供视觉样式的选项。通过添加和删除SARibbonGalleryGroup来组织QAction,并使用SARibbonGallery来显示它们,可以创建自定义的图库,以满足特定的用户需求和设计要求。