KRES::Manager< T > Class Template Reference

#include <manager.h>

Inheritance diagram for KRES::Manager< T >:

Classes
class	ActiveIterator
class	Iterator

Public Member Functions
	Manager (const QString &family)
ActiveIterator	activeBegin ()
ActiveIterator	activeEnd ()
void	add (Resource *resource)
void	addObserver (ManagerObserver< T > *observer)
Iterator	begin ()
void	change (T *resource)
T *	createResource (const QString &type)
Iterator	end ()
bool	isEmpty () const
void	readConfig (KConfig *cfg=0)
void	remove (Resource *resource)
void	removeObserver (ManagerObserver< T > *observer)
QStringList	resourceNames () const
QStringList	resourceTypeDescriptions () const
QStringList	resourceTypeNames () const
void	setActive (Resource *resource, bool active)
void	setStandardResource (T *resource)
T *	standardResource ()
void	writeConfig (KConfig *cfg=0)

Detailed Description

template<class T>
class KRES::Manager< T >

This class provides a manager for resources of a specified family.

It takes care of loading and saving resource configurations and provides access to the resources and their attributes. External changes in the resource configuration are notified by the ManagerObserver interface. If your application needs to be notified about resource configuration changes, you have to subclass ManagerObserver and add it to the Manager by addObserver().

Since KDE 3.4 it's required to supply your application with a *.desktop file for each resource family you introduce. The ServiceType should be of KResources/Manager.

Definition at line 82 of file manager.h.

Constructor & Destructor Documentation

template<class T>

KRES::Manager< T >::Manager ( const QString &  family )

inline

Create manager for given resource family.

The family argument is used as identifier for loading and saving resource configurations.

Definition at line 246 of file manager.h.

Member Function Documentation

template<class T>

ActiveIterator KRES::Manager< T >::activeBegin ( )

inline

Return Iterator on first active resource.

If there is no active resource returns end().

Definition at line 212 of file manager.h.

template<class T>

ActiveIterator KRES::Manager< T >::activeEnd ( )

inline

Return Iterator indicating end of active resource list.

Definition at line 228 of file manager.h.

template<class T>

void KRES::Manager< T >::add ( Resource *  resource )

inline

Add resource to manager.

This passes ownership of the Resource object to the manager.

Definition at line 281 of file manager.h.

template<class T>

void KRES::Manager< T >::addObserver ( ManagerObserver< T > *  observer )

inline

Add observer for resource changes to manager.

See ManagerObserver. The Manager does not take ownership of the Observer object.

Definition at line 391 of file manager.h.

template<class T>

Iterator KRES::Manager< T >::begin ( )

inline

Return Iterator on first resource.

If there is no resource returns end().

Definition at line 137 of file manager.h.

template<class T>

void KRES::Manager< T >::change ( T *  resource )

inline

Call this to notify manager about changes of the configuration of the given resource.

Definition at line 302 of file manager.h.

template<class T>

T* KRES::Manager< T >::createResource ( const QString &  type )

inline

Creates a new resource of type type with default settings.

The resource is not added to the manager, the application has to do that. Returns a pointer to a resource object or a null pointer if resource type doesn't exist.

Parameters

type	The type of the resource, one of those returned by resourceTypeNames()

Definition at line 354 of file manager.h.

template<class T>

Iterator KRES::Manager< T >::end ( )

inline

Return Iterator indicating end of resource list.

Definition at line 147 of file manager.h.

template<class T>

bool KRES::Manager< T >::isEmpty ( ) const

inline

Return true, if manager doesn't hold any resources.

If there are resources return false.

Definition at line 240 of file manager.h.

template<class T>

void KRES::Manager< T >::readConfig ( KConfig *  cfg = 0 )

inline

Recreate Resource objects from configuration file.

If cfg is 0, read standard configuration file determined by family name.

Definition at line 263 of file manager.h.

template<class T>

void KRES::Manager< T >::remove ( Resource *  resource )

inline

Remove resource from manager.

This deletes the Resource object.

Definition at line 291 of file manager.h.

template<class T>

void KRES::Manager< T >::removeObserver ( ManagerObserver< T > *  observer )

inline

Remove Observer for resource changes from manager.

See ManagerObserver. The Observer is not deleted by the Manager after being removed.

Definition at line 400 of file manager.h.

template<class T>

QStringList KRES::Manager< T >::resourceNames ( ) const

inline

Returns a list of the names of the resources managed by the Manager for this family.

Definition at line 339 of file manager.h.

template<class T>

QStringList KRES::Manager< T >::resourceTypeDescriptions ( ) const

inline

Return list of descriptions of all available resource types.

Definition at line 370 of file manager.h.

template<class T>

QStringList KRES::Manager< T >::resourceTypeNames ( ) const

inline

Returns a list of the names of all available resource types.

Definition at line 362 of file manager.h.

template<class T>

void KRES::Manager< T >::setActive ( Resource *  resource, bool  active  )

inline

Set active state of resource.

Definition at line 328 of file manager.h.

template<class T>

void KRES::Manager< T >::setStandardResource ( T *  resource )

inline

Set standard resource.

Definition at line 318 of file manager.h.

template<class T>

T* KRES::Manager< T >::standardResource ( )

inline

Return standard resource.

Definition at line 310 of file manager.h.

template<class T>

void KRES::Manager< T >::writeConfig ( KConfig *  cfg = 0 )

inline

Write configuration of Resource objects to configuration file.

If cfg is 0, write to standard configuration file determined by family name.

Definition at line 272 of file manager.h.

---

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

• manager.h