barrier/lib/synergy/IScreenSaver.h

/*
 * synergy-plus -- mouse and keyboard sharing utility
 * Copyright (C) 2009 The Synergy+ Project
 * Copyright (C) 2002 Chris Schoeneman
 * 
 * This package is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * found in the file COPYING that should have accompanied this file.
 * 
 * This package is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef ISCREENSAVER_H
#define ISCREENSAVER_H

#include "IInterface.h"
#include "CEvent.h"

//! Screen saver interface
/*!
This interface defines the methods common to all screen savers.
*/
class IScreenSaver : public IInterface {
public:
	// note -- the c'tor/d'tor must *not* enable/disable the screen saver

	//! @name manipulators
	//@{

	//! Enable screen saver
	/*!
	Enable the screen saver, restoring the screen saver settings to
	what they were when disable() was previously called.  If disable()
	wasn't previously called then it should keep the current settings
	or use reasonable defaults.
	*/
	virtual void		enable() = 0;

	//! Disable screen saver
	/*!
	Disable the screen saver, saving the old settings for the next
	call to enable().
	*/
	virtual void		disable() = 0;

	//! Activate screen saver
	/*!
	Activate (i.e. show) the screen saver.
	*/
	virtual void		activate() = 0;

	//! Deactivate screen saver
	/*!
	Deactivate (i.e. hide) the screen saver, reseting the screen saver
	timer.
	*/
	virtual void		deactivate() = 0;

	//@}
	//! @name accessors
	//@{

	//! Test if screen saver on
	/*!
	Returns true iff the screen saver is currently active (showing).
	*/
	virtual bool		isActive() const = 0;

	//@}
};

#endif