Playtree: handle delete nicely
[vlc.git] / modules / gui / skins2 / utils / var_tree.hpp
1 /*****************************************************************************
2  * var_tree.hpp
3  *****************************************************************************
4  * Copyright (C) 2005 VideoLAN
5  * $Id$
6  *
7  * Authors: Antoine Cellerier <dionoea@videolan.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 #ifndef VAR_TREE_HPP
25 #define VAR_TREE_HPP
26
27 #include <list>
28
29 #include "variable.hpp"
30 #include "observer.hpp"
31 #include "ustring.hpp"
32 #include "var_percent.hpp"
33
34 /// Description of an update to the tree
35 typedef struct tree_update
36 {
37      int i_type;
38      int i_parent;
39      int i_id;
40      bool b_active_item;
41      bool b_visible;
42 } tree_update;
43
44 /// Tree variable
45 class VarTree: public Variable, public Subject<VarTree, tree_update*>
46 {
47     public:
48         VarTree( intf_thread_t *pIntf );
49
50         VarTree( intf_thread_t *pIntf, VarTree *pParent, int id,
51                  const UStringPtr &rcString, bool selected, bool playing,
52                  bool expanded,bool readonly, void *pData );
53
54         virtual ~VarTree();
55
56         /// Get the variable type
57         virtual const string &getType() const { return m_type; }
58
59         /// Add a pointer on string in the children's list
60         virtual void add( int id, const UStringPtr &rcString, bool selected,
61                           bool playing, bool expanded, bool readonly,
62                           void *pData );
63
64         /// Remove the selected item from the children's list
65         virtual void delSelected();
66
67         /// Remove all elements from the children's list
68         virtual void clear();
69
70         /// \todo Use accessors for these fields ?
71         int m_id;
72         UStringPtr m_cString;
73         bool m_selected;
74         bool m_playing;
75         bool m_expanded;
76         bool m_deleted;
77         void *m_pData;
78
79         inline bool isReadonly() { return m_readonly; };
80
81         /// Get the number of children
82         int size() const { return m_children.size(); }
83
84         /// Iterators
85         typedef list<VarTree>::iterator Iterator;
86         typedef list<VarTree>::const_iterator ConstIterator;
87
88         /// Begining of the children's list
89         Iterator begin() { return m_children.begin(); }
90         ConstIterator begin() const { return m_children.begin(); }
91
92         /// End of children's list
93         Iterator end() { return m_children.end(); }
94         ConstIterator end() const { return m_children.end(); }
95
96         /// Back of children's list
97         VarTree &back() { return m_children.back(); }
98
99         /// Return an iterator on the n'th element of the children's list
100         Iterator operator[]( int n );
101         ConstIterator operator[]( int n ) const;
102
103         /// Parent node
104         VarTree *parent() { return m_pParent; }
105         void checkParents( VarTree *pParent );
106
107         /// Get next sibling
108         Iterator getNextSibling( Iterator );
109
110         Iterator next_uncle();
111         Iterator prev_uncle();
112
113         /// Get root node
114         VarTree *root()
115         {
116             VarTree *parent = this;
117             while( parent->parent() != NULL )
118                 parent = parent->parent();
119             return parent;
120         }
121
122         /// Get depth (root depth is 0)
123         int depth()
124         {
125             VarTree *parent = this;
126             int depth = 0;
127             while( ( parent = parent->parent() ) != NULL )
128                 depth++;
129             return depth;
130         }
131
132         void removeChild( VarTree::Iterator item )
133         {
134             m_children.erase( item );
135         }
136
137         /// Execute the action associated to this item
138         virtual void action( VarTree *pItem ) {}
139
140         /// Get a reference on the position variable
141         VarPercent &getPositionVar() const
142         { return *((VarPercent*)m_cPosition.get()); }
143
144         /// Get a counted pointer on the position variable
145         const VariablePtr &getPositionVarPtr() const { return m_cPosition; }
146
147         /// Count the number of items that should be displayed if the playlist window wasn't limited
148         int visibleItems();
149
150         /// Return iterator to the n'th visible item
151         Iterator getVisibleItem( int n );
152
153         /// Given an iterator to a visible item, return the next visible item
154         Iterator getNextVisibleItem( Iterator it );
155
156         /// Given an it to a visible item, return the previous visible item
157         Iterator getPrevVisibleItem( Iterator it );
158
159         /// Given an iterator to an item, return the next item
160         Iterator getNextItem( Iterator it );
161
162         /// Find a children node with the given id
163         Iterator findById( int id );
164
165         /// Ensure an item is expanded
166         void ensureExpanded( VarTree::Iterator );
167
168     private:
169         /// List of children
170         list<VarTree> m_children;
171
172         /// Pointer to parent node
173         VarTree *m_pParent;
174
175         bool m_readonly;
176
177         /// Variable type
178         static const string m_type;
179
180         /// Position variable
181         VariablePtr m_cPosition;
182 };
183
184 #endif