The preference widget class. More...

#include <PrefWidgets.h>

Public Member Functions
QByteArray entryName () const
	Returns the widget's preference name. More...

virtual void OnChange (Base::Subject< const char * > &rCaller, const char *sReason)
	This method is called if one or more values in the parameter settings are changed where getParamGrp() points to. More...

void onRestore ()
	Restores the preferences of the widget. More...

void onSave ()
	Saves the current preferences of the widget. More...

QByteArray paramGrpPath () const
	Returns the widget's preferences path. More...

void setEntryName (const QByteArray &name)
	Sets the preference name to name. More...

void setParamGrpPath (const QByteArray &path)
	Sets the preference path to path. More...

Public Member Functions inherited from Gui::WindowParameter
ParameterGrp::handle getWindowParameter (void)
	return the parameter group of this window More...

void OnChange (Base::Subject< const char * > &rCaller, const char *sReason)

bool setGroupName (const char *name)
	Sets the group of the window to name. More...

WindowParameter (const char *name)

virtual ~WindowParameter ()

Protected Member Functions
void failedToRestore (const QString &) const
	Print warning that restoring failed. More...

void failedToSave (const QString &) const
	Print warning that saving failed. More...

PrefWidget ()
	Constructs a preference widget. More...

virtual void restorePreferences ()=0
	Restores the preferences Must be reimplemented in any subclasses. More...

virtual void savePreferences ()=0
	Save the preferences Must be reimplemented in any subclasses. More...

virtual ~PrefWidget ()
	Destroys the widget and detaches it from its parameter group. More...

Friends
class Gui::WidgetFactoryInst

Additional Inherited Members
Static Public Member Functions inherited from Gui::WindowParameter
static ParameterGrp::handle getDefaultParameter (void)
	get the parameters More...

Detailed Description

The preference widget class.

If you want to extend a QWidget class to save/restore its data you just have to derive from this class and implement the methods restorePreferences() and savePreferences().

To restore and save the settings of any widgets in own dialogs you have call onRestore() e.g. in the dialog's constructor and call onSave() e.g. in accept() for each widget you want to enable this mechanism.

For more information of how to use these widgets in normal container widgets which are again in a dialog refer to the description of Gui::Dialog::DlgPreferencesImp.

Author: Werner Mayer

Constructor & Destructor Documentation

◆ PrefWidget()

PrefWidget::PrefWidget ( )

protected

Constructs a preference widget.

◆ ~PrefWidget()

PrefWidget::~PrefWidget ( )

protectedvirtual

Destroys the widget and detaches it from its parameter group.

References Base::Subject< _MessageType >::Detach(), Gui::WindowParameter::getWindowParameter(), and femsolver.elmer.sifio::isValid().

Member Function Documentation

◆ entryName()

QByteArray PrefWidget::entryName ( ) const

Returns the widget's preference name.

◆ failedToRestore()

void PrefWidget::failedToRestore ( const QString & name ) const

protected

Print warning that restoring failed.

References Base::ConsoleSingleton::Warning().

Referenced by Gui::PrefSpinBox::restorePreferences(), Gui::PrefDoubleSpinBox::restorePreferences(), Gui::PrefLineEdit::restorePreferences(), Gui::PrefFileChooser::restorePreferences(), Gui::PrefComboBox::restorePreferences(), Gui::PrefCheckBox::restorePreferences(), Gui::PrefRadioButton::restorePreferences(), Gui::PrefSlider::restorePreferences(), Gui::PrefColorButton::restorePreferences(), Gui::PrefUnitSpinBox::restorePreferences(), and Gui::PrefFontBox::restorePreferences().

◆ failedToSave()

void PrefWidget::failedToSave ( const QString & name ) const

protected

Print warning that saving failed.

References Base::ConsoleSingleton::Warning().

Referenced by Gui::PrefSpinBox::savePreferences(), Gui::PrefDoubleSpinBox::savePreferences(), Gui::PrefLineEdit::savePreferences(), Gui::PrefFileChooser::savePreferences(), Gui::PrefComboBox::savePreferences(), Gui::PrefCheckBox::savePreferences(), Gui::PrefRadioButton::savePreferences(), Gui::PrefSlider::savePreferences(), Gui::PrefColorButton::savePreferences(), Gui::PrefUnitSpinBox::savePreferences(), and Gui::PrefFontBox::savePreferences().

◆ OnChange()

void PrefWidget::OnChange	(	Base::Subject< const char * > &	rCaller,
		const char *	sReason
	)

virtual

This method is called if one or more values in the parameter settings are changed where getParamGrp() points to.

Note: This method is called for each parameter inside the parameter group. So you have to filter out the appropriate parameter with the name sReason. rCaller calls this method.

References restorePreferences().