2 * Copyright (C) 2001 Red Hat, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library 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 GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 #include "gtktreednd.h"
24 gtk_tree_drag_source_get_type (void)
26 static GType our_type = 0;
30 static const GTypeInfo our_info =
32 sizeof (GtkTreeDragSourceIface), /* class_size */
34 NULL, /* base_finalize */
36 NULL, /* class_finalize */
37 NULL, /* class_data */
43 our_type = g_type_register_static (G_TYPE_INTERFACE, "GtkTreeDragSource", &our_info, 0);
51 gtk_tree_drag_dest_get_type (void)
53 static GType our_type = 0;
57 static const GTypeInfo our_info =
59 sizeof (GtkTreeDragDestIface), /* class_size */
61 NULL, /* base_finalize */
63 NULL, /* class_finalize */
64 NULL, /* class_data */
70 our_type = g_type_register_static (G_TYPE_INTERFACE, "GtkTreeDragDest", &our_info, 0);
78 * gtk_tree_drag_source_drag_data_delete:
79 * @drag_source: a #GtkTreeDragSource
80 * @path: row that was being dragged
82 * Asks the #GtkTreeDragSource to delete the row at @path, because
83 * it was moved somewhere else via drag-and-drop. Returns %FALSE
84 * if the deletion fails because @path no longer exists, or for
85 * some model-specific reason. Should robustly handle a @path no
86 * longer found in the model!
88 * Return value: %TRUE if the row was successfully deleted
91 gtk_tree_drag_source_drag_data_delete (GtkTreeDragSource *drag_source,
94 GtkTreeDragSourceIface *iface = GTK_TREE_DRAG_SOURCE_GET_IFACE (drag_source);
96 g_return_val_if_fail (iface->drag_data_delete != NULL, FALSE);
97 g_return_val_if_fail (path != NULL, FALSE);
99 return (* iface->drag_data_delete) (drag_source, path);
103 * gtk_tree_drag_source_drag_data_get:
104 * @drag_source: a #GtkTreeDragSource
105 * @path: row that was dragged
106 * @selection_data: a #GtkSelectionData to fill with data from the dragged row
108 * Asks the #GtkTreeDragSource to fill in @selection_data with a
109 * representation of the row at @path. @selection_data->target gives
110 * the required type of the data. Should robustly handle a @path no
111 * longer found in the model!
113 * Return value: %TRUE if data of the required type was provided
116 gtk_tree_drag_source_drag_data_get (GtkTreeDragSource *drag_source,
118 GtkSelectionData *selection_data)
120 GtkTreeDragSourceIface *iface = GTK_TREE_DRAG_SOURCE_GET_IFACE (drag_source);
122 g_return_val_if_fail (iface->drag_data_get != NULL, FALSE);
123 g_return_val_if_fail (path != NULL, FALSE);
124 g_return_val_if_fail (selection_data != NULL, FALSE);
126 return (* iface->drag_data_get) (drag_source, path, selection_data);
130 * gtk_tree_drag_dest_drag_data_received:
131 * @drag_dest: a #GtkTreeDragDest
132 * @dest: row to drop in front of
133 * @selection_data: data to drop
135 * Asks the #GtkTreeDragDest to insert a row before the path @dest,
136 * deriving the contents of the row from @selection_data. If @dest is
137 * outside the tree so that inserting before it is impossible, %FALSE
138 * will be returned. Also, %FALSE may be returned if the new row is
139 * not created for some model-specific reason. Should robustly handle
140 * a @dest no longer found in the model!
142 * Return value: whether a new row was created before position @dest
145 gtk_tree_drag_dest_drag_data_received (GtkTreeDragDest *drag_dest,
147 GtkSelectionData *selection_data)
149 GtkTreeDragDestIface *iface = GTK_TREE_DRAG_DEST_GET_IFACE (drag_dest);
151 g_return_val_if_fail (iface->drag_data_received != NULL, FALSE);
152 g_return_val_if_fail (dest != NULL, FALSE);
153 g_return_val_if_fail (selection_data != NULL, FALSE);
155 return (* iface->drag_data_received) (drag_dest, dest, selection_data);
160 * gtk_tree_drag_dest_drop_possible:
161 * @drag_dest: a #GtkTreeDragDest
162 * @src_model: #GtkTreeModel being dragged from
163 * @src_path: row being dragged
164 * @dest_path: destination row
166 * Determines whether a drop is possible before the given @dest_path,
167 * at the same depth as @dest_path. i.e., can we drop @src_model such
168 * that it now resides at @dest_path. @dest_path does not have to
169 * exist; the return value will almost certainly be %FALSE if the
170 * parent of @dest_path doesn't exist, though.
172 * Return value: %TRUE if a drop is possible before @dest_path
175 gtk_tree_drag_dest_row_drop_possible (GtkTreeDragDest *drag_dest,
176 GtkTreeModel *src_model,
177 GtkTreePath *src_path,
178 GtkTreePath *dest_path)
180 GtkTreeDragDestIface *iface = GTK_TREE_DRAG_DEST_GET_IFACE (drag_dest);
182 g_return_val_if_fail (iface->row_drop_possible != NULL, FALSE);
183 g_return_val_if_fail (GTK_IS_TREE_MODEL (src_model), FALSE);
184 g_return_val_if_fail (src_path != NULL, FALSE);
185 g_return_val_if_fail (dest_path != NULL, FALSE);
187 return (* iface->row_drop_possible) (drag_dest, src_model, src_path, dest_path);
190 typedef struct _TreeRowData TreeRowData;
199 * gtk_selection_data_set_tree_row:
200 * @selection_data: some #GtkSelectionData
201 * @tree_model: a #GtkTreeModel
202 * @path: a row in @tree_model
204 * Sets selection data of target type %GTK_TREE_MODEL_ROW. Normally used
205 * in a drag_data_get handler.
207 * Return value: %TRUE if the #GtkSelectionData had the proper target type to allow us to set a tree row
210 gtk_selection_data_set_tree_row (GtkSelectionData *selection_data,
211 GtkTreeModel *tree_model,
219 g_return_val_if_fail (selection_data != NULL, FALSE);
220 g_return_val_if_fail (GTK_IS_TREE_MODEL (tree_model), FALSE);
221 g_return_val_if_fail (path != NULL, FALSE);
223 if (selection_data->target != gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
226 path_str = gtk_tree_path_to_string (path);
228 len = strlen (path_str);
230 /* the old allocate-end-of-struct-to-hold-string trick */
231 struct_size = sizeof (TreeRowData) + len + 1 -
232 (sizeof (TreeRowData) - G_STRUCT_OFFSET (TreeRowData, path));
234 trd = g_malloc (struct_size);
236 strcpy (trd->path, path_str);
238 trd->model = tree_model;
240 gtk_selection_data_set (selection_data,
241 gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE),
252 * gtk_selection_data_get_tree_row:
253 * @selection_data: a #GtkSelectionData
254 * @tree_model: a #GtkTreeModel
255 * @path: row in @tree_model
257 * Obtains a @tree_model and @path from selection data of target type
258 * %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler.
259 * This function can only be used if @selection_data originates from the same
260 * process that's calling this function, because a pointer to the tree model
261 * is being passed around. If you aren't in the same process, then you'll
262 * get memory corruption. In the #GtkTreeDragDest drag_data_received handler,
263 * you can assume that selection data of type %GTK_TREE_MODEL_ROW is
264 * in from the current process. The returned path must be freed with
265 * gtk_tree_path_free().
267 * Return value: %TRUE if @selection_data had target type %GTK_TREE_MODEL_ROW and
271 gtk_selection_data_get_tree_row (GtkSelectionData *selection_data,
272 GtkTreeModel **tree_model,
277 g_return_val_if_fail (selection_data != NULL, FALSE);
285 if (selection_data->target != gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
288 trd = (void*) selection_data->data;
291 *tree_model = trd->model;
294 *path = gtk_tree_path_new_from_string (trd->path);