1 /*
2  * This file is part of gtkD.
3  *
4  * gtkD is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU Lesser General Public License
6  * as published by the Free Software Foundation; either version 3
7  * of the License, or (at your option) any later version, with
8  * some exceptions, please read the COPYING file.
9  *
10  * gtkD is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public License
16  * along with gtkD; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
18  */
19 
20 // generated automatically - do not change
21 // find conversion definition on APILookup.txt
22 // implement new conversion functionalities on the wrap.utils pakage
23 
24 
25 module gtk.TreeDragSourceIF;
26 
27 private import gobject.ObjectG;
28 private import gtk.SelectionData;
29 private import gtk.TreeModel;
30 private import gtk.TreeModelIF;
31 private import gtk.TreePath;
32 private import gtkc.gtk;
33 public  import gtkc.gtktypes;
34 
35 
36 /** */
37 public interface TreeDragSourceIF{
38 	/** Get the main Gtk struct */
39 	public GtkTreeDragSource* getTreeDragSourceStruct();
40 
41 	/** the main Gtk struct as a void* */
42 	protected void* getStruct();
43 
44 
45 	/**
46 	 * Asks the #GtkTreeDragSource to delete the row at @path, because
47 	 * it was moved somewhere else via drag-and-drop. Returns %FALSE
48 	 * if the deletion fails because @path no longer exists, or for
49 	 * some model-specific reason. Should robustly handle a @path no
50 	 * longer found in the model!
51 	 *
52 	 * Params:
53 	 *     path = row that was being dragged
54 	 *
55 	 * Returns: %TRUE if the row was successfully deleted
56 	 */
57 	public bool dragDataDelete(TreePath path);
58 
59 	/**
60 	 * Asks the #GtkTreeDragSource to fill in @selection_data with a
61 	 * representation of the row at @path. @selection_data->target gives
62 	 * the required type of the data.  Should robustly handle a @path no
63 	 * longer found in the model!
64 	 *
65 	 * Params:
66 	 *     path = row that was dragged
67 	 *     selectionData = a #GtkSelectionData to fill with data
68 	 *         from the dragged row
69 	 *
70 	 * Returns: %TRUE if data of the required type was provided
71 	 */
72 	public bool dragDataGet(TreePath path, SelectionData selectionData);
73 
74 	/**
75 	 * Asks the #GtkTreeDragSource whether a particular row can be used as
76 	 * the source of a DND operation. If the source doesn’t implement
77 	 * this interface, the row is assumed draggable.
78 	 *
79 	 * Params:
80 	 *     path = row on which user is initiating a drag
81 	 *
82 	 * Returns: %TRUE if the row can be dragged
83 	 */
84 	public bool rowDraggable(TreePath path);
85 
86 	/**
87 	 * Obtains a @tree_model and @path from selection data of target type
88 	 * %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler.
89 	 * This function can only be used if @selection_data originates from the same
90 	 * process that’s calling this function, because a pointer to the tree model
91 	 * is being passed around. If you aren’t in the same process, then you'll
92 	 * get memory corruption. In the #GtkTreeDragDest drag_data_received handler,
93 	 * you can assume that selection data of type %GTK_TREE_MODEL_ROW is
94 	 * in from the current process. The returned path must be freed with
95 	 * gtk_tree_path_free().
96 	 *
97 	 * Params:
98 	 *     selectionData = a #GtkSelectionData
99 	 *     treeModel = a #GtkTreeModel
100 	 *     path = row in @tree_model
101 	 *
102 	 * Returns: %TRUE if @selection_data had target type %GTK_TREE_MODEL_ROW and
103 	 *     is otherwise valid
104 	 */
105 	public static bool getRowDragData(SelectionData selectionData, out TreeModelIF treeModel, out TreePath path);
106 
107 	/**
108 	 * Sets selection data of target type %GTK_TREE_MODEL_ROW. Normally used
109 	 * in a drag_data_get handler.
110 	 *
111 	 * Params:
112 	 *     selectionData = some #GtkSelectionData
113 	 *     treeModel = a #GtkTreeModel
114 	 *     path = a row in @tree_model
115 	 *
116 	 * Returns: %TRUE if the #GtkSelectionData had the proper target type to allow us to set a tree row
117 	 */
118 	public static bool setRowDragData(SelectionData selectionData, TreeModelIF treeModel, TreePath path);
119 }