makVrv::DtApplicationSettingsManager Class Reference

Application Settings Manager Settings associated with the application that don't merit an additional settings file (one offs, primarily) More...

Inheritance diagram for makVrv::DtApplicationSettingsManager:

Public Member Functions
virtual	~DtApplicationSettingsManager ()
	DTOR.
Setters/getters for settings
virtual void	setViewControlEnabled (bool val)
virtual bool	viewControlEnabled () const
Setting Persistence Methods
void	setFromRecord (const DtApplicationSettingsRecord &rec)
	Set the current settings' state from the given record.
void	getRecord (DtApplicationSettingsRecord &rec) const
	Store the current settings' state in the given record.
Public Member Functions inherited from makVrv::DtBaseSettingsManager< DtApplicationSettingsRecord >
	DtBaseSettingsManager (DtDe &de, const std::string &name, const std::string &displayName, const std::string &ext)
	CTOR.
virtual	~DtBaseSettingsManager ()
	Virtual DTOR.
virtual void	initializeBackup ()
	Creates a backup of the settings' current state.
virtual void	setFromRecord (const DtApplicationSettingsRecord &record)=0
	Set the current settings' state from the given record (abstract).
virtual void	getRecord (DtApplicationSettingsRecord &record) const =0
	Store the current settings' state in the given record (abstract).
Public Member Functions inherited from makVrv::DtCommonBaseSettingsManager< DtApplicationSettingsRecord >
	DtCommonBaseSettingsManager (DtDe &de, const std::string &name, const std::string &displayName, const std::string &ext)
	CTOR The name, displayName, and extension parameters are used for creating the settings object (DtDeSettings) and backup, and for constructing the filename when readin/writing the records to disk.
virtual	~DtCommonBaseSettingsManager ()
	Virtual DTOR.
virtual void	autoSaveIfNecessary ()
	Saves the current settings as defaults if autosave is enabled.
virtual void	setAutoSave (bool doit)
	Sets whether autosave is enabled for the settings manager.
virtual bool	autoSave () const
	Gets whether autosave is enabled for the settings manager.
virtual void	setUseDefaultSettingsRecord (bool useit)
	Sets whether setting initialization should check for a default record.
virtual bool	useDefaultSettingsRecord () const
	Gets whether setting initialization should check for a default record.
virtual DtDeSettings *	settings ()
	Accessor for the manager's DtDeSettings object.
virtual const DtDeSettings *	settings () const
	Accessor for the manager's DtDeSettings object (const).
virtual DtSettingsBackup *	settingsBackup ()
	Accessor for the manager's settings backup.
virtual const DtSettingsBackup *	settingsBackup () const
	Accessor for the manager's settings backup (const).
virtual void	loadDefaults ()
	Initializes the settings and creates a backup.
virtual void	saveDefaultSettings ()
	Saves the current settings' state as the default (on disk).
virtual void	loadDefaultSettings (bool loadOnlyFactorySettings)
	Loads the default settings from disk.
virtual void	importSettings (const std::string &filePath)
	Load the settings' state from the given file.
virtual void	exportSettings (const std::string &filePath) const
	Save the current settings' state to the given file.
Public Member Functions inherited from makVrv::DtVirtualBaseClass
	DtVirtualBaseClass ()
	Do nothing constructor.
virtual	~DtVirtualBaseClass ()
	Virtual do nothing destructor.

Static Public Member Functions
static DtApplicationSettingsManager &	instance (DtDe &de)
	Get an instance of the settings manager.

Public Attributes
Boost signals for changed settings
boost::signal< void(bool)>	signal_viewControlEnabledSet

Protected Member Functions
	DtApplicationSettingsManager (DtDe &)
	CTOR.

Protected Attributes
bool	myViewControlEnabled

Friends
template<typename ManagerClass >
ManagerClass &	defaultManagerInstanceFunction (DtDe &, bool)
	Befriend the manager instance functions for instance retreival/creation.
template<typename ManagerClass >
void	defaultManagerRegisterInstanceFunction (DtDe &, ManagerClass *)
	Befriend the manager instance functions for instance retreival/creation.

Additional Inherited Members
Protected Types inherited from makVrv::DtBaseSettingsManager< DtApplicationSettingsRecord >
typedef DtRecordSettingsBackup < DtBaseSettingsManager < DtApplicationSettingsRecord > , DtApplicationSettingsRecord >	RecordBackupType

Detailed Description

Application Settings Manager Settings associated with the application that don't merit an additional settings file (one offs, primarily)

Constructor & Destructor Documentation

virtual makVrv::DtApplicationSettingsManager::~DtApplicationSettingsManager ( )

virtual

DTOR.

makVrv::DtApplicationSettingsManager::DtApplicationSettingsManager ( DtDe &  )

protected

CTOR.

Member Function Documentation

static DtApplicationSettingsManager& makVrv::DtApplicationSettingsManager::instance ( DtDe &  de )

static

Get an instance of the settings manager.

virtual void makVrv::DtApplicationSettingsManager::setViewControlEnabled ( bool  val )

virtual

virtual bool makVrv::DtApplicationSettingsManager::viewControlEnabled ( ) const

virtual

void makVrv::DtApplicationSettingsManager::setFromRecord

(

const DtApplicationSettingsRecord &

rec

)

Set the current settings' state from the given record.

void makVrv::DtApplicationSettingsManager::getRecord

(

DtApplicationSettingsRecord &

rec

)

const

Store the current settings' state in the given record.

Friends And Related Function Documentation

template<typename ManagerClass >

ManagerClass& defaultManagerInstanceFunction ( DtDe &  de, bool  allowedInSlave  )

friend

Befriend the manager instance functions for instance retreival/creation.

Befriend the manager instance functions for instance retrieval/creation.

  Manager requirements:
  1) Static instance function
  2) Protected DtSignalConnectionManager named myConnections.
  3) Member functioned called loadDefaults which takes no arguments.
     and loads the default settings of the manager or factory from disk.
  4) define defaultManagerInstanceFunction as friend.
  5) define defaultManagerRegisterInstanceFunction as friend (see below).
  5) Protected Constructor which only takes a DtDe reference.
  @code 

class Manager { public: static Manager& instance(DtDe& de); void loadDefaults(); protected: template <typename managerclass>=""> friend ManagerClass& defaultManagerInstanceFunction(DtDe& de, bool); template <typename managerclass>=""> friend void defaultManagerRegisterInstanceFunction(DtDe& de, ManagerClass* mgr) Manager(DtDe&); DtSignalConnectionManager myConnections; };

  Then simply in the implementation of instance call 
  defaultManagerInstanceFunction with the de object and return the return
  value.
  @code 

Manager& Manager::instance(DtDe& de) { return defaultManagerInstanceFunction<Manager>(de); }

template<typename ManagerClass >

void defaultManagerRegisterInstanceFunction ( DtDe &  de, ManagerClass *  mgr  )

friend

Befriend the manager instance functions for instance retreival/creation.

Befriend the manager instance functions for instance retrieval/creation.

  @code 

static void Manager::registerInstance(DtDe& de, Manager* mgr) { defaultManagerRegisterInstanceFunction(de,mgr); } ...else where call. // Assuming class NewManager : public Manager Manager::registerInstance(de,new NewManager(de));

Member Data Documentation

boost::signal<void ( bool )> makVrv::DtApplicationSettingsManager::signal_viewControlEnabledSet

bool makVrv::DtApplicationSettingsManager::myViewControlEnabled

protected

---

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

• /exports/nfedora7-1/nightly/docs/vrforcesDevelopment.vrf4-4-branch/include/vrvCore/DtApplicationSettingsManager.h