mitk::IPreferencesService Class Reference

A service for persistent application preferences. More...

#include <mitkIPreferencesService.h>

Inheritance diagram for mitk::IPreferencesService:

Public Member Functions
virtual	~IPreferencesService ()
	If initialized, ask the preferences backend to flush preferences, i.e. write them to disk. More...
virtual void	InitializeStorage (const std::filesystem::path &filename)=0
	Initialize the preferences backend. More...
virtual void	UninitializeStorage (bool removeFile=true)=0
	For internal use only. More...
virtual IPreferences *	GetSystemPreferences ()=0
	Access preferences. More...

Detailed Description

A service for persistent application preferences.

See also

CoreServices::GetPreferencesService()

IPreferences

Definition at line 33 of file mitkIPreferencesService.h.

Constructor & Destructor Documentation

~IPreferencesService()

virtual mitk::IPreferencesService::~IPreferencesService ( )

virtual

If initialized, ask the preferences backend to flush preferences, i.e. write them to disk.

Member Function Documentation

GetSystemPreferences()

virtual IPreferences* mitk::IPreferencesService::GetSystemPreferences ( )

pure virtual

Access preferences.

The system preferences should be considered as resource and as such their lifetime is coupled to this service. It is recommended to access the preferences always through this method as needed instead of keeping a pointer permanently.

Note

The term "system preferences" is kept for historical reasons to stay as API-compatible as possible to the previous preferences service. A more precise term would be "application preferences".

Returns

The root node of the preferences tree.

Implemented in mitk::PreferencesService.

InitializeStorage()

virtual void mitk::IPreferencesService::InitializeStorage ( const std::filesystem::path &  filename )

pure virtual

Initialize the preferences backend.

Load preferences from the specified file. If the file does not yet exist, create an empty preferences storage.

This method must be called once at the start of an application before accessing any preferences via GetSystemPreferences().

Exceptions

Exception

The method is called more than once.

See also

IPreferencesStorage

Implemented in mitk::PreferencesService.

UninitializeStorage()

virtual void mitk::IPreferencesService::UninitializeStorage ( bool  removeFile = true )

pure virtual

For internal use only.

This method is only used for testing purposes. Do not use in production code.

Implemented in mitk::PreferencesService.

---

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

• mitkIPreferencesService.h