/* === S Y N F I G ========================================================= */
/*! \file selectionmanager.h
** \brief Template Header
**
** $Id$
**
** \legal
** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** 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.
** \endlegal
*/
/* ========================================================================= */
/* === S T A R T =========================================================== */
#ifndef __SYNFIG_APP_SELECTIONMANAGER_H
#define __SYNFIG_APP_SELECTIONMANAGER_H
/* === H E A D E R S ======================================================= */
#include <list>
#include <set>
#include <ETL/handle>
#include <synfig/layer.h>
#include <synfig/valuenode.h>
#include "value_desc.h"
/* === M A C R O S ========================================================= */
/* === T Y P E D E F S ===================================================== */
/* === C L A S S E S & S T R U C T S ======================================= */
namespace synfigapp {
class SelectionManager : public etl::shared_object
{
public:
typedef std::pair<synfig::Layer::Handle,synfig::String> LayerParam;
typedef std::list<LayerParam> LayerParamList;
typedef std::list<synfig::Layer::Handle> LayerList;
typedef std::list<ValueDesc> ChildrenList;
//typedef std::list<synfig::ValueNode::Handle> ValueNodeList;
virtual ~SelectionManager() { }
//! Returns the number of layers selected.
virtual int get_selected_layer_count()const=0;
//! Returns a list of the currently selected layers.
virtual LayerList get_selected_layers()const=0;
//! Returns the first layer selected or an empty handle if none are selected.
virtual synfig::Layer::Handle get_selected_layer()const=0;
//! Sets which layers should be selected
virtual void set_selected_layers(const LayerList &layer_list)=0;
//! Sets which layer should be selected. Empty handle if none.
virtual void set_selected_layer(const synfig::Layer::Handle &layer)=0;
//! Clears the layer selection list
virtual void clear_selected_layers()=0;
virtual LayerList get_expanded_layers()const { return LayerList(); }
virtual void set_expanded_layers(const LayerList & /* layer_list */) { }
//! Returns the number of children selected.
virtual int get_selected_children_count()const=0;
//! Returns a list of the currently selected children.
virtual ChildrenList get_selected_children()const=0;
//! Returns the first children selected or an empty handle if none are selected.
virtual ChildrenList::value_type get_selected_child()const=0;
//! Sets which children should be selected
virtual void set_selected_children(const ChildrenList &children_list)=0;
//! Sets which children should be selected. Empty handle if none.
virtual void set_selected_child(const ChildrenList::value_type &children)=0;
//! Clears the children selection list
virtual void clear_selected_children()=0;
//! Returns the number of layer parameters selected.
virtual int get_selected_layer_parameter_count()const=0;
//! Returns a list of the currently selected layer parameters.
virtual LayerParamList get_selected_layer_parameters()const=0;
//! Returns the first layer parameter selected or an empty handle if none are selected.
virtual LayerParam get_selected_layer_parameter()const=0;
//! Sets which layer parameters should be selected
virtual void set_selected_layer_parameters(const LayerParamList &layer_param_list)=0;
//! Sets which layer parameter should be selected. Empty handle if none.
virtual void set_selected_layer_param(const LayerParam &layer_param)=0;
//! Clears the layer parameter selection list
virtual void clear_selected_layer_parameters()=0;
}; // END of class SelectionManager
//! A place holding selection manager that does nothing
class NullSelectionManager : public SelectionManager
{
public:
int get_selected_layer_count()const { return 0; }
LayerList get_selected_layers()const { return LayerList(); }
synfig::Layer::Handle get_selected_layer()const { return 0; }
void set_selected_layers(const LayerList &/*layer_list*/) { return; }
void set_selected_layer(const synfig::Layer::Handle &/*layer*/) { return; }
void clear_selected_layers() { return; }
int get_selected_children_count()const { return 0; }
ChildrenList get_selected_children()const { return ChildrenList(); }
ChildrenList::value_type get_selected_child()const { return ChildrenList::value_type(); }
void set_selected_children(const ChildrenList &/*children_list*/) { return; }
void set_selected_child(const ChildrenList::value_type &/*child*/) { return; }
void clear_selected_children() { return; }
int get_selected_layer_parameter_count()const { return 0; }
LayerParamList get_selected_layer_parameters()const { return LayerParamList(); }
LayerParam get_selected_layer_parameter()const { return LayerParam(); }
void set_selected_layer_parameters(const LayerParamList &/*layer_param_list*/) { return; }
void set_selected_layer_param(const LayerParam &/*layer_param*/) { return; }
void clear_selected_layer_parameters() { return; }
}; // END of class NullSelectionManager
}; // END of namespace synfigapp
/* === E N D =============================================================== */
#endif