QGIS API Documentation  2.8.2-Wien
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | Protected Slots | Protected Member Functions | Protected Attributes | List of all members
QgsOptionsDialogBase Class Reference

A base dialog for options and properties dialogs that offers vertical tabs. More...

#include <qgsoptionsdialogbase.h>

Public Member Functions

 QgsOptionsDialogBase (QString settingsKey, QWidget *parent=0, Qt::WindowFlags fl=0, QSettings *settings=0)
 ~QgsOptionsDialogBase ()
bool iconOnly ()
 determine if the options list is in icon only mode
void initOptionsBase (bool restoreUi=true, QString title=QString())
 Set up the base ui connections for vertical tabs.
void restoreOptionsBaseUi (QString title=QString())
 Restore the base ui.
void setSettings (QSettings *settings)

Protected Slots

void optionsStackedWidget_CurrentChanged (int indx)
void optionsStackedWidget_WidgetRemoved (int indx)
void updateOptionsListVerticalTabs ()
void warnAboutMissingObjects ()

Protected Member Functions

void paintEvent (QPaintEvent *e) override
void showEvent (QShowEvent *e) override
virtual void updateWindowTitle ()

Protected Attributes

bool mDelSettings
QString mDialogTitle
bool mIconOnly
bool mInit
QDialogButtonBox * mOptButtonBox
QListWidget * mOptListWidget
QString mOptsKey
QSplitter * mOptSplitter
QStackedWidget * mOptStackedWidget
QPointer< QSettings > mSettings

Detailed Description

A base dialog for options and properties dialogs that offers vertical tabs.

It handles saving/restoring of geometry, splitter and current tab states, switching vertical tabs between icon/text to icon-only modes (splitter collapsed to left), and connecting QDialogButtonBox's accepted/rejected signals to dialog's accept/reject slots

To use: 1) Start with copy of qgsoptionsdialog_template.ui and build options/properties dialog. 2) In source file for dialog, inherit this class instead of QDialog, then in constructor: ... setupUi( this ); // set up .ui file objects initOptionsBase( false ); // set up this class to use .ui objects, optionally restoring base ui ... restoreOptionsBaseUi(); // restore the base ui with initOptionsBase or use this later on

Definition at line 48 of file qgsoptionsdialogbase.h.

Constructor & Destructor Documentation

QgsOptionsDialogBase::QgsOptionsDialogBase ( QString  settingsKey,
QWidget *  parent = 0,
Qt::WindowFlags  fl = 0,
QSettings *  settings = 0 


settingsKeyQSettings subgroup key for saving/restore ui states, e.g. "ProjectProperties".
parentparent object (owner)
flwidget flags
settingscustom QSettings pointer

Definition at line 30 of file qgsoptionsdialogbase.cpp.

QgsOptionsDialogBase::~QgsOptionsDialogBase ( )

Definition at line 45 of file qgsoptionsdialogbase.cpp.

Member Function Documentation

bool QgsOptionsDialogBase::iconOnly ( )

determine if the options list is in icon only mode

Definition at line 79 of file qgsoptionsdialogbase.h.

void QgsOptionsDialogBase::initOptionsBase ( bool  restoreUi = true,
QString  title = QString() 

Set up the base ui connections for vertical tabs.

restoreUiWhether to restore the base ui at this time.
titlethe window title

Definition at line 62 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::optionsStackedWidget_CurrentChanged ( int  indx)

Definition at line 271 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::optionsStackedWidget_WidgetRemoved ( int  indx)

Definition at line 280 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::paintEvent ( QPaintEvent *  e)

Definition at line 214 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::restoreOptionsBaseUi ( QString  title = QString())

Restore the base ui.

Sometimes useful to do at end of subclass's constructor.

titlethe window title (it does not need to be defined if previously given to initOptionsBase();

Definition at line 150 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::setSettings ( QSettings *  settings)

Definition at line 139 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::showEvent ( QShowEvent *  e)

Definition at line 199 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::updateOptionsListVerticalTabs ( )

Definition at line 235 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::updateWindowTitle ( )

Definition at line 222 of file qgsoptionsdialogbase.cpp.

void QgsOptionsDialogBase::warnAboutMissingObjects ( )

Definition at line 286 of file qgsoptionsdialogbase.cpp.

Member Data Documentation

bool QgsOptionsDialogBase::mDelSettings

Definition at line 104 of file qgsoptionsdialogbase.h.

QString QgsOptionsDialogBase::mDialogTitle

Definition at line 99 of file qgsoptionsdialogbase.h.

bool QgsOptionsDialogBase::mIconOnly

Definition at line 100 of file qgsoptionsdialogbase.h.

bool QgsOptionsDialogBase::mInit

Definition at line 94 of file qgsoptionsdialogbase.h.

QDialogButtonBox* QgsOptionsDialogBase::mOptButtonBox

Definition at line 98 of file qgsoptionsdialogbase.h.

QListWidget* QgsOptionsDialogBase::mOptListWidget

Definition at line 95 of file qgsoptionsdialogbase.h.

QString QgsOptionsDialogBase::mOptsKey

Definition at line 93 of file qgsoptionsdialogbase.h.

QSplitter* QgsOptionsDialogBase::mOptSplitter

Definition at line 97 of file qgsoptionsdialogbase.h.

QStackedWidget* QgsOptionsDialogBase::mOptStackedWidget

Definition at line 96 of file qgsoptionsdialogbase.h.

QPointer<QSettings> QgsOptionsDialogBase::mSettings

Definition at line 103 of file qgsoptionsdialogbase.h.

The documentation for this class was generated from the following files: