2 Copyright (C) 2010 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __pbd_property_list_h__
21 #define __pbd_property_list_h__
25 #include "pbd/libpbd_visibility.h"
26 #include "pbd/property_basics.h"
32 /** A list of properties, mapped using their ID */
33 class LIBPBD_API PropertyList : public std::map<PropertyID, PropertyBase*>
37 PropertyList (PropertyList const &);
39 virtual ~PropertyList();
41 void get_changes_as_xml (XMLNode*);
44 /** Add a property (of some kind) to the list.
47 * constructing PropertyLists that describe a change/operation.
49 bool add (PropertyBase* prop);
51 /** Construct a new Property List
53 * Code that is constructing a property list for use
54 * in setting the state of an object uses this.
56 * Defined below, once we have Property<T>
58 template<typename T, typename V> bool add (PropertyDescriptor<T> pid, const V& v);
64 /** Persistent Property List
66 * A variant of PropertyList that does not delete its
67 * property list in its destructor. Objects with their
68 * own Properties store them in an OwnedPropertyList
69 * to avoid having them deleted at the wrong time.
71 class LIBPBD_API OwnedPropertyList : public PropertyList
76 /** Add a property to the List
78 * Classes that own property lists use this to add their
79 * property members to their plists. Note that it takes
80 * a reference argument rather than a pointer like
81 * one of the add() methods in PropertyList.
83 bool add (PropertyBase& p);
88 #endif /* __pbd_property_list_h__ */