mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 19:00:08 +00:00
Move documentation to inline comments: GtkDnd
This commit is contained in:
Javier Jardón
parent
911ae50956
commit
f7b7e8a6b8
1
docs/reference/gtk/tmpl/.gitignore
vendored
1
docs/reference/gtk/tmpl/.gitignore
vendored
@ -29,6 +29,7 @@ gtkcombobox.sgml
|
||||
gtkcomboboxentry.sgml
|
||||
gtkcontainer.sgml
|
||||
gtkdialog.sgml
|
||||
gtkdnd.sgml
|
||||
gtkdrawingarea.sgml
|
||||
gtkeditable.sgml
|
||||
gtkentry.sgml
|
||||
|
||||
@ -1,424 +0,0 @@
|
||||
<!-- ##### SECTION Title ##### -->
|
||||
Drag and Drop
|
||||
|
||||
<!-- ##### SECTION Short_Description ##### -->
|
||||
Functions for controlling drag and drop handling
|
||||
|
||||
<!-- ##### SECTION Long_Description ##### -->
|
||||
<para>
|
||||
GTK+ has a rich set of functions for doing inter-process
|
||||
communication via the drag-and-drop metaphor. GTK+
|
||||
can do drag-and-drop (DND) via multiple protocols.
|
||||
The currently supported protocols are the Xdnd and
|
||||
Motif protocols.
|
||||
|
||||
As well as the functions listed here, applications
|
||||
may need to use some facilities provided for
|
||||
<link linkend="gtk-Selections">Selections</link>.
|
||||
Also, the Drag and Drop API makes use of signals
|
||||
in the #GtkWidget class.
|
||||
</para>
|
||||
|
||||
<!-- ##### SECTION See_Also ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
<!-- ##### SECTION Stability_Level ##### -->
|
||||
|
||||
|
||||
<!-- ##### SECTION Image ##### -->
|
||||
|
||||
|
||||
<!-- ##### ENUM GtkDestDefaults ##### -->
|
||||
<para>
|
||||
The #GtkDestDefaults enumeration specifies the various
|
||||
types of action that will be taken on behalf
|
||||
of the user for a drag destination site.
|
||||
</para>
|
||||
|
||||
@GTK_DEST_DEFAULT_MOTION:
|
||||
If set for a widget, GTK+, during a drag over this
|
||||
widget will check if the drag matches this widget's
|
||||
list of possible targets and actions.
|
||||
GTK+ will then call gdk_drag_status() as appropriate.
|
||||
@GTK_DEST_DEFAULT_HIGHLIGHT:
|
||||
If set for a widget, GTK+ will draw a highlight on
|
||||
this widget as long as a drag is over this widget
|
||||
and the widget drag format and action are acceptable.
|
||||
@GTK_DEST_DEFAULT_DROP:
|
||||
If set for a widget, when a drop occurs, GTK+ will
|
||||
will check if the drag matches this widget's
|
||||
list of possible targets and actions. If so,
|
||||
GTK+ will call gtk_drag_get_data() on behalf
|
||||
of the widget. Whether or not the drop is successful,
|
||||
GTK+ will call gtk_drag_finish(). If the action
|
||||
was a move, then if the drag was successful, then
|
||||
%TRUE will be passed for the @delete parameter
|
||||
to gtk_drag_finish().
|
||||
@GTK_DEST_DEFAULT_ALL:
|
||||
If set, specifies that all default actions should
|
||||
be taken.
|
||||
|
||||
<!-- ##### ENUM GtkTargetFlags ##### -->
|
||||
<para>
|
||||
The #GtkTargetFlags enumeration is used to specify
|
||||
constraints on an entry in a #GtkTargetTable.
|
||||
</para>
|
||||
|
||||
@GTK_TARGET_SAME_APP:
|
||||
If this is set, the target will only be selected
|
||||
for drags within a single application.
|
||||
@GTK_TARGET_SAME_WIDGET:
|
||||
If this is set, the target will only be selected
|
||||
for drags within a single widget.
|
||||
@GTK_TARGET_OTHER_APP:
|
||||
If this is set, the target will not be selected
|
||||
for drags within a single application. Since 2.12
|
||||
@GTK_TARGET_OTHER_WIDGET:
|
||||
If this is set, the target will not be selected
|
||||
for drags withing a single widget. Since 2.12
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_set ##### -->
|
||||
<para>
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@flags:
|
||||
@targets:
|
||||
@n_targets:
|
||||
@actions:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_set_proxy ##### -->
|
||||
<para>
|
||||
Sets this widget as a proxy for drops to another window.
|
||||
</para>
|
||||
|
||||
@widget: a #GtkWidget
|
||||
@proxy_window: the window to which to forward drag events
|
||||
@protocol: the drag protocol which the @proxy_window accepts
|
||||
(You can use gdk_drag_get_protocol() to determine this)
|
||||
@use_coordinates: If %TRUE, send the same coordinates to the
|
||||
destination, because it is an embedded
|
||||
subwindow.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_unset ##### -->
|
||||
<para>
|
||||
Clears information about a drop destination set with
|
||||
gtk_drag_dest_set(). The widget will no longer receive
|
||||
notification of drags.
|
||||
</para>
|
||||
|
||||
@widget: a #GtkWidget
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_find_target ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@context:
|
||||
@target_list:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_get_target_list ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_set_target_list ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@target_list:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_add_text_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_add_image_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_add_uri_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_set_track_motion ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@track_motion:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_dest_get_track_motion ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_finish ##### -->
|
||||
<para>
|
||||
Informs the drag source that the drop is finished, and
|
||||
that the data of the drag will no longer be required.
|
||||
</para>
|
||||
|
||||
@context: the drag context.
|
||||
@success: a flag indicating whether the drop was successful
|
||||
@del: a flag indicating whether the source should delete the
|
||||
original data. (This should be %TRUE for a move)
|
||||
@time_: the timestamp from the "drag_data_drop" signal.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_get_data ##### -->
|
||||
<para>
|
||||
Gets the data associated with a drag. When the data
|
||||
is received or the retrieval fails, GTK+ will emit a
|
||||
"drag_data_received" signal. Failure of the retrieval
|
||||
is indicated by the length field of the @selection_data
|
||||
signal parameter being negative. However, when gtk_drag_get_data()
|
||||
is called implicitely because the %GTK_DEST_DEFAULT_DROP was set,
|
||||
then the widget will not receive notification of failed
|
||||
drops.
|
||||
</para>
|
||||
|
||||
@widget: the widget that will receive the "drag_data_received"
|
||||
signal.
|
||||
@context: the drag context
|
||||
@target: the target (form of the data) to retrieve.
|
||||
@time_: a timestamp for retrieving the data. This will
|
||||
generally be the time received in a "drag_data_motion"
|
||||
or "drag_data_drop" signal.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_get_source_widget ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_highlight ##### -->
|
||||
<para>
|
||||
Draws a highlight around a widget. This will attach
|
||||
handlers to "expose_event" and "draw", so the highlight
|
||||
will continue to be displayed until gtk_drag_unhighlight()
|
||||
is called.
|
||||
</para>
|
||||
|
||||
@widget: a widget to highlight
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_unhighlight ##### -->
|
||||
<para>
|
||||
Removes a highlight set by gtk_drag_highlight() from
|
||||
a widget.
|
||||
</para>
|
||||
|
||||
@widget: a widget to remove the highlight from.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_begin ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@targets:
|
||||
@actions:
|
||||
@button:
|
||||
@event:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_widget ##### -->
|
||||
<para>
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@widget:
|
||||
@hot_x:
|
||||
@hot_y:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_pixbuf ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@pixbuf:
|
||||
@hot_x:
|
||||
@hot_y:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_stock ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@stock_id:
|
||||
@hot_x:
|
||||
@hot_y:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_surface ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@surface:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_name ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@context:
|
||||
@icon_name:
|
||||
@hot_x:
|
||||
@hot_y:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_set_icon_default ##### -->
|
||||
<para>
|
||||
</para>
|
||||
|
||||
@context:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_check_threshold ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@start_x:
|
||||
@start_y:
|
||||
@current_x:
|
||||
@current_y:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_set ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@start_button_mask:
|
||||
@targets:
|
||||
@n_targets:
|
||||
@actions:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_set_icon_pixbuf ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@pixbuf:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_set_icon_stock ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@stock_id:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_set_icon_name ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@icon_name:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_unset ##### -->
|
||||
<para>
|
||||
Undoes the effects of gtk_drag_source_set().
|
||||
</para>
|
||||
|
||||
@widget: a #GtkWidget
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_set_target_list ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@target_list:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_get_target_list ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_add_text_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_add_image_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_drag_source_add_uri_targets ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@widget:
|
||||
|
||||
|
||||
148
gtk/gtkdnd.c
148
gtk/gtkdnd.c
@ -52,6 +52,26 @@
|
||||
#include "gtkdndcursors.h"
|
||||
#include "gtkselectionprivate.h"
|
||||
|
||||
|
||||
/**
|
||||
* SECTION:gtkdnd
|
||||
* @Short_description: Functions for controlling drag and drop handling
|
||||
* @Title: Drag and Drop
|
||||
*
|
||||
* GTK+ has a rich set of functions for doing inter-process
|
||||
* communication via the drag-and-drop metaphor. GTK+
|
||||
* can do drag-and-drop (DND) via multiple protocols.
|
||||
* The currently supported protocols are the Xdnd and
|
||||
* Motif protocols.
|
||||
*
|
||||
* As well as the functions listed here, applications
|
||||
* may need to use some facilities provided for
|
||||
* <link linkend="gtk-Selections">Selections</link>.
|
||||
* Also, the Drag and Drop API makes use of signals
|
||||
* in the #GtkWidget class.
|
||||
*/
|
||||
|
||||
|
||||
static GSList *source_widgets = NULL;
|
||||
|
||||
typedef struct _GtkDragSourceSite GtkDragSourceSite;
|
||||
@ -958,13 +978,23 @@ gtk_drag_update_cursor (GtkDragSourceInfo *info)
|
||||
********************/
|
||||
|
||||
/**
|
||||
* gtk_drag_get_data: (method)
|
||||
* @widget: a #GtkWidget
|
||||
* @context: drag context
|
||||
* @target: format to retrieve the data in.
|
||||
* @time_: timestamp of triggering event.
|
||||
* gtk_drag_get_data:
|
||||
* @widget: the widget that will receive the
|
||||
* #GtkWidget::drag-data-received signal.
|
||||
* @context: the drag context
|
||||
* @target: the target (form of the data) to retrieve.
|
||||
* @time_: a timestamp for retrieving the data. This will
|
||||
* generally be the time received in a #GtkWidget::drag-motion"
|
||||
* or #GtkWidget::drag-drop" signal.
|
||||
*
|
||||
* Get the data for a drag or drop
|
||||
* Gets the data associated with a drag. When the data
|
||||
* is received or the retrieval fails, GTK+ will emit a
|
||||
* #GtkWidget::drag-data-received signal. Failure of the retrieval
|
||||
* is indicated by the length field of the @selection_data
|
||||
* signal parameter being negative. However, when gtk_drag_get_data()
|
||||
* is called implicitely because the %GTK_DEST_DEFAULT_DROP was set,
|
||||
* then the widget will not receive notification of failed
|
||||
* drops.
|
||||
*/
|
||||
void
|
||||
gtk_drag_get_data (GtkWidget *widget,
|
||||
@ -1030,17 +1060,17 @@ gtk_drag_get_source_widget (GdkDragContext *context)
|
||||
return NULL;
|
||||
}
|
||||
|
||||
/*************************************************************
|
||||
/**
|
||||
* gtk_drag_finish:
|
||||
* Notify the drag source that the transfer of data
|
||||
* is complete.
|
||||
* arguments:
|
||||
* context: The drag context for this drag
|
||||
* success: Was the data successfully transferred?
|
||||
* time: The timestamp to use when notifying the destination.
|
||||
* results:
|
||||
*************************************************************/
|
||||
|
||||
* @context: the drag context.
|
||||
* @success: a flag indicating whether the drop was successful
|
||||
* @del: a flag indicating whether the source should delete the
|
||||
* original data. (This should be %TRUE for a move)
|
||||
* @time_: the timestamp from the #GtkWidget::drag-drop signal.
|
||||
*
|
||||
* Informs the drag source that the drop is finished, and
|
||||
* that the data of the drag will no longer be required.
|
||||
*/
|
||||
void
|
||||
gtk_drag_finish (GdkDragContext *context,
|
||||
gboolean success,
|
||||
@ -1121,11 +1151,14 @@ gtk_drag_highlight_draw (GtkWidget *widget,
|
||||
return FALSE;
|
||||
}
|
||||
|
||||
/**
|
||||
* gtk_drag_highlight: (method)
|
||||
* @widget: a #GtkWidget
|
||||
/**
|
||||
* gtk_drag_highlight:
|
||||
* @widget: a widget to highlight
|
||||
*
|
||||
* Highlight the given widget in the default manner.
|
||||
* Draws a highlight around a widget. This will attach
|
||||
* handlers to #GtkWidget::draw, so the highlight
|
||||
* will continue to be displayed until gtk_drag_unhighlight()
|
||||
* is called.
|
||||
*/
|
||||
void
|
||||
gtk_drag_highlight (GtkWidget *widget)
|
||||
@ -1139,11 +1172,12 @@ gtk_drag_highlight (GtkWidget *widget)
|
||||
gtk_widget_queue_draw (widget);
|
||||
}
|
||||
|
||||
/**
|
||||
* gtk_drag_unhighlight: (method)
|
||||
* @widget: a #GtkWidget
|
||||
/**
|
||||
* gtk_drag_unhighlight:
|
||||
* @widget: a widget to remove the highlight from.
|
||||
*
|
||||
* Refresh the given widget to remove the highlight.
|
||||
* Removes a highlight set by gtk_drag_highlight() from
|
||||
* a widget.
|
||||
*/
|
||||
void
|
||||
gtk_drag_unhighlight (GtkWidget *widget)
|
||||
@ -1206,22 +1240,22 @@ gtk_drag_dest_set_internal (GtkWidget *widget,
|
||||
*
|
||||
* The default behaviors listed in @flags have an effect similar
|
||||
* to installing default handlers for the widget's drag-and-drop signals
|
||||
* (#GtkWidget:drag-motion, #GtkWidget:drag-drop, ...). They all exist
|
||||
* (#GtkWidget::drag-motion, #GtkWidget::drag-drop, ...). They all exist
|
||||
* for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is
|
||||
* sufficient to connect to the widget's #GtkWidget::drag-data-received
|
||||
* signal to get primitive, but consistent drag-and-drop support.
|
||||
*
|
||||
* Things become more complicated when you try to preview the dragged data,
|
||||
* as described in the documentation for #GtkWidget:drag-motion. The default
|
||||
* as described in the documentation for #GtkWidget::drag-motion. The default
|
||||
* behaviors described by @flags make some assumptions, that can conflict
|
||||
* with your own signal handlers. For instance #GTK_DEST_DEFAULT_DROP causes
|
||||
* invokations of gdk_drag_status() in the context of #GtkWidget:drag-motion,
|
||||
* and invokations of gtk_drag_finish() in #GtkWidget:drag-data-received.
|
||||
* Especially the later is dramatic, when your own #GtkWidget:drag-motion
|
||||
* invokations of gdk_drag_status() in the context of #GtkWidget::drag-motion,
|
||||
* and invokations of gtk_drag_finish() in #GtkWidget::drag-data-received.
|
||||
* Especially the later is dramatic, when your own #GtkWidget::drag-motion
|
||||
* handler calls gtk_drag_get_data() to inspect the dragged data.
|
||||
*
|
||||
* There's no way to set a default action here, you can use the
|
||||
* #GtkWidget:drag-motion callback for that. Here's an example which selects
|
||||
* #GtkWidget::drag-motion callback for that. Here's an example which selects
|
||||
* the action to use depending on whether the control key is pressed or not:
|
||||
* |[
|
||||
* static void
|
||||
@ -1270,15 +1304,16 @@ gtk_drag_dest_set (GtkWidget *widget,
|
||||
}
|
||||
|
||||
/**
|
||||
* gtk_drag_dest_set_proxy: (method)
|
||||
* gtk_drag_dest_set_proxy:
|
||||
* @widget: a #GtkWidget
|
||||
* @proxy_window: window to which forward drag events
|
||||
* @protocol: Drag protocol which the dest widget accepts
|
||||
* @use_coordinates: If true, send the same coordinates to the
|
||||
* destination, because it is a embedded
|
||||
* subwindow.
|
||||
* @proxy_window: the window to which to forward drag events
|
||||
* @protocol: the drag protocol which the @proxy_window accepts
|
||||
* (You can use gdk_drag_get_protocol() to determine this)
|
||||
* @use_coordinates: If %TRUE, send the same coordinates to the
|
||||
* destination, because it is an embedded
|
||||
* subwindow.
|
||||
*
|
||||
* Set up this widget to proxy drags elsewhere.
|
||||
* Sets this widget as a proxy for drops to another window.
|
||||
*/
|
||||
void
|
||||
gtk_drag_dest_set_proxy (GtkWidget *widget,
|
||||
@ -1308,11 +1343,13 @@ gtk_drag_dest_set_proxy (GtkWidget *widget,
|
||||
gtk_drag_dest_set_internal (widget, site);
|
||||
}
|
||||
|
||||
/**
|
||||
* gtk_drag_dest_unset: (method)
|
||||
/**
|
||||
* gtk_drag_dest_unset:
|
||||
* @widget: a #GtkWidget
|
||||
*
|
||||
* Unregister this widget as a drag target.
|
||||
* Clears information about a drop destination set with
|
||||
* gtk_drag_dest_set(). The widget will no longer receive
|
||||
* notification of drags.
|
||||
*/
|
||||
void
|
||||
gtk_drag_dest_unset (GtkWidget *widget)
|
||||
@ -1477,10 +1514,10 @@ gtk_drag_dest_add_uri_targets (GtkWidget *widget)
|
||||
* gtk_drag_dest_set_track_motion: (method)
|
||||
* @widget: a #GtkWidget that's a drag destination
|
||||
* @track_motion: whether to accept all targets
|
||||
*
|
||||
* Tells the widget to emit ::drag-motion and ::drag-leave
|
||||
* events regardless of the targets and the %GTK_DEST_DEFAULT_MOTION
|
||||
* flag.
|
||||
*
|
||||
* Tells the widget to emit #GtkWidget::drag-motion and
|
||||
* #GtkWidget::drag-leave events regardless of the targets and the
|
||||
* %GTK_DEST_DEFAULT_MOTION flag.
|
||||
*
|
||||
* This may be used when a widget wants to do generic
|
||||
* actions regardless of the targets that the source offers.
|
||||
@ -1505,11 +1542,12 @@ gtk_drag_dest_set_track_motion (GtkWidget *widget,
|
||||
/**
|
||||
* gtk_drag_dest_get_track_motion: (method)
|
||||
* @widget: a #GtkWidget that's a drag destination
|
||||
*
|
||||
*
|
||||
* Returns whether the widget has been configured to always
|
||||
* emit ::drag-motion signals.
|
||||
*
|
||||
* Return Value: %TRUE if the widget always emits ::drag-motion events
|
||||
* emit #GtkWidget::drag-motion signals.
|
||||
*
|
||||
* Return Value: %TRUE if the widget always emits
|
||||
* #GtkWidget::drag-motion events
|
||||
*
|
||||
* Since: 2.10
|
||||
**/
|
||||
@ -2513,18 +2551,18 @@ gtk_drag_begin_internal (GtkWidget *widget,
|
||||
* grab the pointer. If @event is #NULL, then GDK_CURRENT_TIME will be used.
|
||||
* However, you should try to pass a real event in all cases, since that can be
|
||||
* used by GTK+ to get information about the start position of the drag, for
|
||||
* example if the @event is a GDK_MOTION_NOTIFY.
|
||||
* example if the @event is a %GDK_MOTION_NOTIFY.
|
||||
*
|
||||
* Generally there are three cases when you want to start a drag by hand by
|
||||
* calling this function:
|
||||
*
|
||||
* 1. During a button-press-event handler, if you want to start a drag
|
||||
* 1. During a #GtkWidget::button-press-event handler, if you want to start a drag
|
||||
* immediately when the user presses the mouse button. Pass the @event
|
||||
* that you have in your button-press-event handler.
|
||||
* that you have in your #GtkWidget::button-press-event handler.
|
||||
*
|
||||
* 2. During a motion-notify-event handler, if you want to start a drag
|
||||
* 2. During a #GtkWidget::motion-notify-event handler, if you want to start a drag
|
||||
* when the mouse moves past a certain threshold distance after a button-press.
|
||||
* Pass the @event that you have in your motion-notify-event handler.
|
||||
* Pass the @event that you have in your #GtkWidget::motion-notify-event handler.
|
||||
*
|
||||
* 3. During a timeout handler, if you want to start a drag after the mouse
|
||||
* button is held down for some time. Try to save the last event that you got
|
||||
@ -2613,10 +2651,10 @@ gtk_drag_source_set (GtkWidget *widget,
|
||||
}
|
||||
|
||||
/**
|
||||
* gtk_drag_source_unset: (method)
|
||||
* gtk_drag_source_unset:
|
||||
* @widget: a #GtkWidget
|
||||
*
|
||||
* Unregister this widget as a drag source.
|
||||
* Undoes the effects of gtk_drag_source_set().
|
||||
*/
|
||||
void
|
||||
gtk_drag_source_unset (GtkWidget *widget)
|
||||
|
||||
36
gtk/gtkdnd.h
36
gtk/gtkdnd.h
@ -39,6 +39,28 @@
|
||||
|
||||
G_BEGIN_DECLS
|
||||
|
||||
/**
|
||||
* GtkDestDefaults:
|
||||
* @GTK_DEST_DEFAULT_MOTION: If set for a widget, GTK+, during a drag over this
|
||||
* widget will check if the drag matches this widget's list of possible targets
|
||||
* and actions.
|
||||
* GTK+ will then call gdk_drag_status() as appropriate.
|
||||
* @GTK_DEST_DEFAULT_HIGHLIGHT: If set for a widget, GTK+ will draw a highlight on
|
||||
* this widget as long as a drag is over this widget and the widget drag format
|
||||
* and action are acceptable.
|
||||
* @GTK_DEST_DEFAULT_DROP: If set for a widget, when a drop occurs, GTK+ will
|
||||
* will check if the drag matches this widget's list of possible targets and
|
||||
* actions. If so, GTK+ will call gtk_drag_get_data() on behalf of the widget.
|
||||
* Whether or not the drop is successful, GTK+ will call gtk_drag_finish(). If
|
||||
* the action was a move, then if the drag was successful, then %TRUE will be
|
||||
* passed for the @delete parameter to gtk_drag_finish().
|
||||
* @GTK_DEST_DEFAULT_ALL: If set, specifies that all default actions should
|
||||
* be taken.
|
||||
*
|
||||
* The #GtkDestDefaults enumeration specifies the various
|
||||
* types of action that will be taken on behalf
|
||||
* of the user for a drag destination site.
|
||||
*/
|
||||
typedef enum {
|
||||
GTK_DEST_DEFAULT_MOTION = 1 << 0, /* respond to "drag_motion" */
|
||||
GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1, /* auto-highlight */
|
||||
@ -46,7 +68,19 @@ typedef enum {
|
||||
GTK_DEST_DEFAULT_ALL = 0x07
|
||||
} GtkDestDefaults;
|
||||
|
||||
/* Flags for the GtkTargetEntry on the destination side
|
||||
/**
|
||||
* GtkTargetFlags:
|
||||
* @GTK_TARGET_SAME_APP: If this is set, the target will only be selected
|
||||
* for drags within a single application.
|
||||
* @GTK_TARGET_SAME_WIDGET: If this is set, the target will only be selected
|
||||
* for drags within a single widget.
|
||||
* @GTK_TARGET_OTHER_APP: If this is set, the target will not be selected
|
||||
* for drags within a single application.
|
||||
* @GTK_TARGET_OTHER_WIDGET: If this is set, the target will not be selected
|
||||
* for drags withing a single widget.
|
||||
*
|
||||
* The #GtkTargetFlags enumeration is used to specify
|
||||
* constraints on an entry in a #GtkTargetTable.
|
||||
*/
|
||||
typedef enum {
|
||||
GTK_TARGET_SAME_APP = 1 << 0, /*< nick=same-app >*/
|
||||
|
||||
Loading…
Reference in New Issue
Block a user