Document that the drag icon window will be modified
This is in response to the complaint in https://bugzilla.gnome.org/show_bug.cgi?id=732991
This commit is contained in:
parent
609f4c05ae
commit
cfec3ba794
17
gtk/gtkdnd.c
17
gtk/gtkdnd.c
@ -3206,15 +3206,20 @@ gtk_drag_set_icon_window (GdkDragContext *context,
|
|||||||
* gtk_drag_set_icon_widget: (method)
|
* gtk_drag_set_icon_widget: (method)
|
||||||
* @context: the context for a drag. (This must be called
|
* @context: the context for a drag. (This must be called
|
||||||
with a context for the source side of a drag)
|
with a context for the source side of a drag)
|
||||||
* @widget: a toplevel window to use as an icon.
|
* @widget: a toplevel window to use as an icon
|
||||||
* @hot_x: the X offset within @widget of the hotspot.
|
* @hot_x: the X offset within @widget of the hotspot
|
||||||
* @hot_y: the Y offset within @widget of the hotspot.
|
* @hot_y: the Y offset within @widget of the hotspot
|
||||||
*
|
*
|
||||||
* Changes the icon for a widget to a given widget. GTK+
|
* Changes the icon for a widget to a given widget.
|
||||||
* will not destroy the icon, so if you don’t want
|
* GTK+ will not destroy the icon, so if you don’t want
|
||||||
* it to persist, you should connect to the “drag-end”
|
* it to persist, you should connect to the “drag-end”
|
||||||
* signal and destroy it yourself.
|
* signal and destroy it yourself.
|
||||||
**/
|
*
|
||||||
|
* GTK+ will, however, change the opacity and position of
|
||||||
|
* the window as part of the drag animation. If you want
|
||||||
|
* to reuse the window, you have to restore these to
|
||||||
|
* the values you need after each drag operation.
|
||||||
|
*/
|
||||||
void
|
void
|
||||||
gtk_drag_set_icon_widget (GdkDragContext *context,
|
gtk_drag_set_icon_widget (GdkDragContext *context,
|
||||||
GtkWidget *widget,
|
GtkWidget *widget,
|
||||||
|
Loading…
Reference in New Issue
Block a user