summaryrefslogtreecommitdiff
path: root/gtk/gtkiconview.c
diff options
context:
space:
mode:
authorClaudio Saavedra <csaavedra@igalia.com>2009-01-24 22:22:35 +0000
committerClaudio Saavedra <csaavedra@src.gnome.org>2009-01-24 22:22:35 +0000
commit42f7d0390719fad517fa636619ac1923bb1c75f3 (patch)
tree1e6a611d9821228c0dfc2ff37ca1797d60ff5690 /gtk/gtkiconview.c
parent1db176de7f9f4c3d0a1dd8d79259052aebf4bccc (diff)
downloadgtk+-42f7d0390719fad517fa636619ac1923bb1c75f3.tar.gz
Bug 559420 – gtk_icon_view_enable_model_drag_[source|dest] docs wrt.
2009-01-24 Claudio Saavedra <csaavedra@igalia.com> Bug 559420 – gtk_icon_view_enable_model_drag_[source|dest] docs wrt. reorderable property * gtk/gtkiconview.c: Improve docstrings regarding reorderable property. Based on a patch by Björn Lindqvist. svn path=/trunk/; revision=22211
Diffstat (limited to 'gtk/gtkiconview.c')
-rw-r--r--gtk/gtkiconview.c14
1 files changed, 9 insertions, 5 deletions
diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c
index ff7b11153d..f3d7c4f897 100644
--- a/gtk/gtkiconview.c
+++ b/gtk/gtkiconview.c
@@ -7009,8 +7009,9 @@ gtk_icon_view_drag_data_received (GtkWidget *widget,
* @n_targets: the number of items in @targets
* @actions: the bitmask of possible actions for a drag from this
* widget
- *
- * Turns @icon_view into a drag source for automatic DND.
+ *
+ * Turns @icon_view into a drag source for automatic DND. Calling this
+ * method sets #GtkIconView:reorderable to %FALSE.
*
* Since: 2.8
**/
@@ -7040,8 +7041,9 @@ gtk_icon_view_enable_model_drag_source (GtkIconView *icon_view,
* @n_targets: the number of items in @targets
* @actions: the bitmask of possible actions for a drag to this
* widget
- *
- * Turns @icon_view into a drop destination for automatic DND.
+ *
+ * Turns @icon_view into a drop destination for automatic DND. Calling this
+ * method sets #GtkIconView:reorderable to %FALSE.
*
* Since: 2.8
**/
@@ -7366,7 +7368,9 @@ static const GtkTargetEntry item_targets[] = {
* #GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then
* the user can reorder the model by dragging and dropping rows. The
* developer can listen to these changes by connecting to the model's
- * row_inserted and row_deleted signals.
+ * row_inserted and row_deleted signals. The reordering is implemented by setting up
+ * the icon view as a drag source and destination. Therefore, drag and
+ * drop can not be used in a reorderable view for any other purpose.
*
* This function does not give you any degree of control over the order -- any
* reordering is allowed. If more control is needed, you should probably