Add keyboard shortcut to tooltip text where possible.
[ardour.git] / libs / gtkmm2ext / gtkmm2ext / dndtreeview.h
1 /*
2     Copyright (C) 2000-2007 Paul Davis 
3
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.
8
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.
13
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.
17
18 */
19
20 #ifndef __gtkmm2ext_dndtreeview_h__
21 #define __gtkmm2ext_dndtreeview_h__
22
23 #include <stdint.h>
24 #include <string>
25 #include <gtkmm/treeview.h>
26 #include <gtkmm/treeselection.h>
27 #include <gtkmm/selectiondata.h>
28
29 namespace Gtkmm2ext {
30
31 template<class DataType>
32 struct SerializedObjectPointers {
33     uint32_t size;
34     uint32_t cnt;
35     char     type[32];
36     DataType data[0];
37 };
38
39 class DnDTreeViewBase : public Gtk::TreeView 
40 {
41   private:
42   public:
43         DnDTreeViewBase ();
44         ~DnDTreeViewBase() {}
45
46         void add_drop_targets (std::list<Gtk::TargetEntry>&);
47         void add_object_drag (int column, std::string type_name);
48
49         void on_drag_begin (Glib::RefPtr<Gdk::DragContext> const & context) {
50                 Gtk::TreeView::on_drag_begin (context);
51                 start_object_drag ();
52         }
53         
54         void on_drag_leave(const Glib::RefPtr<Gdk::DragContext>& context, guint time) {
55                 suggested_action = context->get_suggested_action();
56                 TreeView::on_drag_leave (context, time);
57         }
58
59         bool on_drag_motion(const Glib::RefPtr<Gdk::DragContext>& context, int x, int y, guint time) {
60                 suggested_action = context->get_suggested_action();
61                 return TreeView::on_drag_motion (context, x, y, time);
62         }
63
64         bool on_drag_drop(const Glib::RefPtr<Gdk::DragContext>& context, int x, int y, guint time);
65
66   protected:
67         std::list<Gtk::TargetEntry> draggable;
68         Gdk::DragAction             suggested_action;
69         int                         data_column;
70         std::string                 object_type;
71
72         struct DragData {
73             Gtk::TreeView* source;
74             int            data_column;
75             std::string    object_type;
76         };
77         
78         static DragData drag_data;
79
80         void start_object_drag () {
81                 drag_data.source = this;
82                 drag_data.data_column = data_column;
83                 drag_data.object_type = object_type;
84         }
85 };
86
87 template<class DataType>
88 class DnDTreeView : public DnDTreeViewBase
89 {
90   public:
91         DnDTreeView() {} 
92         ~DnDTreeView() {}
93
94         sigc::signal<void,const std::list<DataType>&,Gtk::TreeView*,int,int,Glib::RefPtr<Gdk::DragContext>&> signal_drop;
95
96         void on_drag_data_get(const Glib::RefPtr<Gdk::DragContext>& context, Gtk::SelectionData& selection_data, guint info, guint time) {
97                 if (selection_data.get_target() == "GTK_TREE_MODEL_ROW") {
98
99                         TreeView::on_drag_data_get (context, selection_data, info, time);
100
101                 } else if (selection_data.get_target() == object_type) {
102
103                         /* we don't care about the data passed around by DnD, but
104                            we have to provide something otherwise it will stop.
105                          */
106
107                         guchar c;
108                         selection_data.set (8, (guchar*)&c, 1);
109                 }
110         }
111         
112         void on_drag_data_received(const Glib::RefPtr<Gdk::DragContext>& context, int x, int y, const Gtk::SelectionData& selection_data, guint info, guint time) {
113                 if (suggested_action) {
114                         /* this is a drag motion callback. just update the status to
115                            say that we are still dragging, and that's it.
116                         */
117                         suggested_action = Gdk::DragAction (0);
118                         TreeView::on_drag_data_received (context, x, y, selection_data, info, time);
119                         return;
120                 }
121                 
122                 if (selection_data.get_target() == "GTK_TREE_MODEL_ROW") {
123                         
124                         TreeView::on_drag_data_received (context, x, y, selection_data, info, time);
125                         
126
127                 } else if (selection_data.get_target() == object_type) {
128                         
129                         end_object_drag (const_cast<Glib::RefPtr<Gdk::DragContext>& > (context), x, y);
130
131                 } else {
132                         /* some kind of target type added by the app, which will be handled by a signal handler */
133                 }
134         }
135
136         /**
137          * this can be called by the Treeview itself or by some other
138          * object that wants to get the list of dragged items.
139          */
140
141         void get_object_drag_data (std::list<DataType>& l, Gtk::TreeView** source) {
142                 Glib::RefPtr<Gtk::TreeModel> model = drag_data.source->get_model();
143                 DataType v;
144                 Gtk::TreeSelection::ListHandle_Path selection = drag_data.source->get_selection()->get_selected_rows ();
145                 
146                 for (Gtk::TreeSelection::ListHandle_Path::iterator x = selection.begin(); x != selection.end(); ++x) {
147                         model->get_iter (*x)->get_value (drag_data.data_column, v);
148                         l.push_back (v);
149                 }
150                 
151                 *source = drag_data.source;
152         }
153
154   private:
155         void end_object_drag (Glib::RefPtr<Gdk::DragContext>& context, int x, int y) {
156                 std::list<DataType> l;
157                 Gtk::TreeView* source;
158                 get_object_drag_data (l, &source);
159                 signal_drop (l, source, x, y, context);
160         }
161
162 };
163
164 } // namespace
165  
166 #endif /* __gtkmm2ext_dndtreeview_h__ */