一项 ribbon tab 页更多...

#include <qxribbon/ribbonpage.h>

类 QxRibbon::RibbonPage 继承关系图:

Public 成员函数
	RibbonPage (QWidget *parent=Q_NULLPTR)

	RibbonPage (const QString &name, QWidget *parent=Q_NULLPTR)

	~RibbonPage () override

RibbonBar *	ribbonBar () const

QString	pageName () const

void	setPageName (const QString &title)

QString	title () const

RibbonGroup::GroupLayoutMode	groupLayoutMode () const

RibbonGroup *	addGroup (const QString &title)
	添加group

void	addGroup (RibbonGroup *group)
	添加group

RibbonGroup *	insertGroup (int index, const QString &title)
	新建一个group，并插入到index位置

RibbonGroup *	group (int index) const
	通过索引找到group，如果超过索引范围，会返回Q_NULLPTR

RibbonGroup *	groupByName (const QString &title) const
	通过名字查找group

RibbonGroup *	groupByObjectName (const QString &objname) const
	通过ObjectName查找group

int	groupIndex (RibbonGroup *group) const
	查找group对应的索引

void	moveGroup (int from, int to)
	移动一个Group从from index到to index

bool	takeGroup (RibbonGroup *group)

bool	removeGroup (RibbonGroup *group)
	移除Group，Page会直接回收RibbonGroup内存

bool	removeGroup (int index)
	移除group

void	clearGroups ()

int	groupCount () const

QList< RibbonGroup * >	groupList () const

QList< RibbonGroup * >	groups () const

void	setBackgroundBrush (const QBrush &brush)

QSize	sizeHint () const override

bool	isPageContext () const
	如果是ContextPage，此函数返回true

bool	isCanCustomize () const

void	setCanCustomize (bool b)

void	updateItemGeometry ()
	刷新page的布局，适用于改变ribbon的模式之后调用

void	setTitle (const QString &title)

Protected 成员函数
void	setGroupLayoutMode (RibbonGroup::GroupLayoutMode m)

void	markIsPageContext (bool isPageContext=true)
	标记这个是上下文标签

bool	event (QEvent *e) override

void	resizeEvent (QResizeEvent *e) override

void	wheelEvent (QWheelEvent *event) override

友元
class	RibbonBar

class	RibbonBarPrivate

class	RibbonPageContext

详细描述

一项 ribbon tab 页

注解: RibbonPage 的 windowTitle 影响了其在 RibbonBar 的标签显示，如果要改标签名字，直接调用 RibbonPage 的 setWindowTitle 函数

在文件 ribbonpage.h 第 29 行定义.

构造及析构函数说明

◆ RibbonPage() [1/2]

QxRibbon::RibbonPage::RibbonPage ( QWidget * parent = Q_NULLPTR )

explicit

在文件 ribbonpage.cpp 第 454 行定义.

◆ RibbonPage() [2/2]

QxRibbon::RibbonPage::RibbonPage	(	const QString &	name,
		QWidget *	parent = `Q_NULLPTR`
	)

explicit

在文件 ribbonpage.cpp 第 464 行定义.

◆ ~RibbonPage()

QxRibbon::RibbonPage::~RibbonPage ( )

override

在文件 ribbonpage.cpp 第 470 行定义.

成员函数说明

◆ addGroup() [1/2]

RibbonGroup * QxRibbon::RibbonPage::addGroup ( const QString & title )

添加group

注解: group的所有权由RibbonPage来管理，请不要在外部对其进行销毁

参数

title group的标题，在office/wps的三行模式下会显示在group的下方

返回: 返回生成的RibbonGroup 指针

参见: 对RibbonGroup的其他操作，参考 RibbonPage::takeGroup

在文件 ribbonpage.cpp 第 510 行定义.

◆ addGroup() [2/2]

void QxRibbon::RibbonPage::addGroup ( RibbonGroup * group )

添加group

参数

group group的所有权RibbonPage来管理

在文件 ribbonpage.cpp 第 520 行定义.

◆ clearGroups()

void QxRibbon::RibbonPage::clearGroups ( )

在文件 ribbonpage.cpp 第 668 行定义.

◆ event()

bool QxRibbon::RibbonPage::event ( QEvent * e )

overrideprotected

在文件 ribbonpage.cpp 第 763 行定义.

◆ group()

RibbonGroup * QxRibbon::RibbonPage::group ( int index ) const

通过索引找到group，如果超过索引范围，会返回Q_NULLPTR

参数

index

返回: 如果超过索引范围，会返回Q_NULLPTR

在文件 ribbonpage.cpp 第 543 行定义.

◆ groupByName()

RibbonGroup * QxRibbon::RibbonPage::groupByName ( const QString & title ) const

通过名字查找group

参数

title

返回: 如果有重名，只会返回第一个符合条件的

在文件 ribbonpage.cpp 第 554 行定义.

◆ groupByObjectName()

RibbonGroup * QxRibbon::RibbonPage::groupByObjectName ( const QString & objname ) const

通过ObjectName查找group

参数

objname

返回: 如果有重名，只会返回第一个符合条件的

在文件 ribbonpage.cpp 第 572 行定义.

◆ groupCount()

int QxRibbon::RibbonPage::groupCount ( ) const

在文件 ribbonpage.cpp 第 711 行定义.

◆ groupIndex()

int QxRibbon::RibbonPage::groupIndex ( RibbonGroup * group ) const

查找group对应的索引

参数

group

返回: 如果找不到，返回-1

在文件 ribbonpage.cpp 第 590 行定义.

◆ groupLayoutMode()

RibbonGroup::GroupLayoutMode QxRibbon::RibbonPage::groupLayoutMode ( ) const

在文件 ribbonpage.cpp 第 490 行定义.

◆ groupList()

QList< RibbonGroup * > QxRibbon::RibbonPage::groupList ( ) const

在文件 ribbonpage.cpp 第 677 行定义.

◆ groups()

QList< RibbonGroup * > QxRibbon::RibbonPage::groups ( ) const

在文件 ribbonpage.cpp 第 683 行定义.

◆ insertGroup()

RibbonGroup * QxRibbon::RibbonPage::insertGroup	(	int	index,
		const QString &	title
	)

新建一个group，并插入到index位置

参数

title	group的title
index	插入的位置，如果index超出page里group的个数，将插入到最后

返回: 返回生成的RibbonGroup 指针

在文件 ribbonpage.cpp 第 532 行定义.

◆ isCanCustomize()

bool QxRibbon::RibbonPage::isCanCustomize ( ) const

在文件 ribbonpage.cpp 第 717 行定义.

◆ isPageContext()

bool QxRibbon::RibbonPage::isPageContext ( ) const

如果是ContextPage，此函数返回true

返回

在文件 ribbonpage.cpp 第 705 行定义.

◆ markIsPageContext()

void QxRibbon::RibbonPage::markIsPageContext ( bool isPageContext = true )

protected

标记这个是上下文标签

参数

isPageContext

在文件 ribbonpage.cpp 第 757 行定义.

◆ moveGroup()

void QxRibbon::RibbonPage::moveGroup	(	int	from,
		int	to
	)

移动一个Group从from index到to index

参数

from	要移动group的index
to	要移动到的位置

在文件 ribbonpage.cpp 第 608 行定义.

◆ pageName()

QString QxRibbon::RibbonPage::pageName ( ) const

在文件 ribbonpage.cpp 第 475 行定义.

◆ removeGroup() [1/2]

bool QxRibbon::RibbonPage::removeGroup ( int index )

移除group

参数

index group的索引，如果超出会返回false

返回: 成功返回true

在文件 ribbonpage.cpp 第 658 行定义.

◆ removeGroup() [2/2]

bool QxRibbon::RibbonPage::removeGroup ( RibbonGroup * group )

移除Group，Page会直接回收RibbonGroup内存

参数

group 需要移除的group

注解: 移除后group为野指针，一般操作完建议把group指针设置为Q_NULLPTR

此操作等同于：

RibbonGroup *group;
...
page->takeGroup(group);
group->hide();
group->deleteLater();

在文件 ribbonpage.cpp 第 647 行定义.

◆ resizeEvent()

void QxRibbon::RibbonPage::resizeEvent ( QResizeEvent * e )

overrideprotected

在文件 ribbonpage.cpp 第 777 行定义.

◆ ribbonBar()

RibbonBar * QxRibbon::RibbonPage::ribbonBar ( ) const

在文件 ribbonpage.cpp 第 729 行定义.

◆ setBackgroundBrush()

void QxRibbon::RibbonPage::setBackgroundBrush ( const QBrush & brush )

在文件 ribbonpage.cpp 第 688 行定义.

◆ setCanCustomize()

void QxRibbon::RibbonPage::setCanCustomize ( bool b )

在文件 ribbonpage.cpp 第 723 行定义.

◆ setGroupLayoutMode()

void QxRibbon::RibbonPage::setGroupLayoutMode ( RibbonGroup::GroupLayoutMode m )

protected

在文件 ribbonpage.cpp 第 496 行定义.

◆ setPageName()

void QxRibbon::RibbonPage::setPageName ( const QString & title )

在文件 ribbonpage.cpp 第 480 行定义.

◆ setTitle()

void QxRibbon::RibbonPage::setTitle ( const QString & title )

在文件 ribbonpage.cpp 第 748 行定义.

◆ sizeHint()

QSize QxRibbon::RibbonPage::sizeHint ( ) const

override

在文件 ribbonpage.cpp 第 695 行定义.

◆ takeGroup()

bool QxRibbon::RibbonPage::takeGroup ( RibbonGroup * group )

在文件 ribbonpage.cpp 第 626 行定义.

◆ title()

QString QxRibbon::RibbonPage::title ( ) const

在文件 ribbonpage.cpp 第 485 行定义.

◆ updateItemGeometry()

void QxRibbon::RibbonPage::updateItemGeometry ( )

刷新page的布局，适用于改变ribbon的模式之后调用

在文件 ribbonpage.cpp 第 738 行定义.

◆ wheelEvent()

void QxRibbon::RibbonPage::wheelEvent ( QWheelEvent * event )

overrideprotected

在文件 ribbonpage.cpp 第 784 行定义.

友元及相关函数文档

◆ RibbonBar

friend class RibbonBar

friend

在文件 ribbonpage.h 第 93 行定义.

◆ RibbonBarPrivate

friend class RibbonBarPrivate

friend

在文件 ribbonpage.h 第 94 行定义.

◆ RibbonPageContext

friend class RibbonPageContext

friend

在文件 ribbonpage.h 第 95 行定义.

该类的文档由以下文件生成:

src/libs/qxribbon/ribbonpage.h
src/libs/qxribbon/ribbonpage.cpp

Public 成员函数

Protected 成员函数

友元

详细描述

构造及析构函数说明

◆ RibbonPage() [1/2]

◆ RibbonPage() [2/2]

◆ ~RibbonPage()

成员函数说明

◆ addGroup() [1/2]

◆ addGroup() [2/2]

◆ clearGroups()

◆ event()

◆ group()

◆ groupByName()

◆ groupByObjectName()

◆ groupCount()

◆ groupIndex()

◆ groupLayoutMode()

◆ groupList()

◆ groups()

◆ insertGroup()

◆ isCanCustomize()

◆ isPageContext()

◆ markIsPageContext()

◆ moveGroup()

◆ pageName()

◆ removeGroup() [1/2]

◆ removeGroup() [2/2]

◆ resizeEvent()

◆ ribbonBar()

◆ setBackgroundBrush()

◆ setCanCustomize()

◆ setGroupLayoutMode()

◆ setPageName()

◆ setTitle()

◆ sizeHint()

◆ takeGroup()

◆ title()

◆ updateItemGeometry()

◆ wheelEvent()

友元及相关函数文档

◆ RibbonBar

◆ RibbonBarPrivate

◆ RibbonPageContext