A groupbox that collapses/expands when toggled and can save its collapsed and checked states. More...

#include <qgscollapsiblegroupbox.h>

Inheritance diagram for QgsCollapsibleGroupBox:

Collaboration diagram for QgsCollapsibleGroupBox:

Public Member Functions
	QgsCollapsibleGroupBox (QWidget parent=0, QSettings settings=0)
	QgsCollapsibleGroupBox (const QString &title, QWidget parent=0, QSettings settings=0)
	~QgsCollapsibleGroupBox ()
void	setSettings (QSettings *settings)
void	setSaveCollapsedState (bool save)
	set this to false to not save/restore collapsed state
void	setSaveCheckedState (bool save)
	set this to true to save/restore checked state
bool	saveCollapsedState ()
bool	saveCheckedState ()
void	setSettingGroup (const QString &group)
	set this to a defined string to share save/restore states across different parent dialogs
QString	settingGroup () const
Public Member Functions inherited from QgsCollapsibleGroupBoxBasic
	QgsCollapsibleGroupBoxBasic (QWidget *parent=0)
	QgsCollapsibleGroupBoxBasic (const QString &title, QWidget *parent=0)
	~QgsCollapsibleGroupBoxBasic ()
bool	isCollapsed () const
void	setCollapsed (bool collapse)
QString	syncGroup () const
	Named group which synchronizes collapsing action when triangle is clicked while holding alt modifier key.
void	setSyncGroup (QString grp)
void	setScrollOnExpand (bool scroll)
	set this to false to not automatically scroll parent QScrollArea to this widget's contents when expanded

Protected Slots
void	loadState ()
void	saveState ()

Protected Member Functions
void	init ()
void	showEvent (QShowEvent *event)
QString	saveKey () const
Protected Member Functions inherited from QgsCollapsibleGroupBoxBasic
void	collapseExpandFixes ()
	Visual fixes for when group box is collapsed/expanded.
void	mousePressEvent (QMouseEvent *event)
void	mouseReleaseEvent (QMouseEvent *event)
void	changeEvent (QEvent *event)
void	updateStyle ()
QRect	titleRect () const
void	clearModifiers ()

Protected Attributes
QPointer< QSettings >	mSettings
bool	mDelSettings
bool	mSaveCollapsedState
bool	mSaveCheckedState
QString	mSettingGroup
Protected Attributes inherited from QgsCollapsibleGroupBoxBasic
bool	mCollapsed
bool	mInitFlat
bool	mInitFlatChecked
bool	mScrollOnExpand
bool	mShown
QScrollArea *	mParentScrollArea
QgsGroupBoxCollapseButton *	mCollapseButton
QWidget *	mSyncParent
QString	mSyncGroup
bool	mAltDown
bool	mShiftDown
bool	mTitleClicked

Properties
bool	collapsed
bool	saveCollapsedState
bool	saveCheckedState
QString	syncGroup
Properties inherited from QgsCollapsibleGroupBoxBasic
bool	collapsed
QString	syncGroup

Additional Inherited Members
Public Slots inherited from QgsCollapsibleGroupBoxBasic
void	checkToggled (bool ckd)
void	checkClicked (bool ckd)
void	toggleCollapsed ()
Signals inherited from QgsCollapsibleGroupBoxBasic
void	collapsedStateChanged (bool collapsed)
	Signal emitted when groupbox collapsed/expanded state is changed, and when first shown.
Static Protected Attributes inherited from QgsCollapsibleGroupBoxBasic
static QIcon	mCollapseIcon
static QIcon	mExpandIcon

Detailed Description

A groupbox that collapses/expands when toggled and can save its collapsed and checked states.

By default, it auto-saves only its collapsed state to the global settings based on the widget and it's parent names. Holding Alt modifier key when toggling collapsed state will synchronize the toggling across other collapsible group boxes with the same syncGroup QString value Holding Shift modifier key when attempting to toggle collapsed state will expand current group box, then collapse any others with the same syncGroup QString value

See Also: basic class QgsCollapsibleGroupBoxBasic which does not auto-save states

Note: To add Collapsible properties in promoted QtDesigner widgets, you can add the following "Dynamic properties" by clicking on the green + in the propreties palette: bool collapsed, bool saveCollapsedState, bool saveCheckedState, QString syncGroup

Definition at line 145 of file qgscollapsiblegroupbox.h.