/usr/share/gtk-doc/html/pygtk/class-gdkdragcontext.html is in python-gtk2-doc 2.24.0-4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.gdk.DragContext</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gdk-class-reference.html" title="The gtk.gdk Class Reference"><link rel="prev" href="class-gdkdisplaymanager.html" title="gtk.gdk.DisplayManager"><link rel="next" href="class-gdkdrawable.html" title="gtk.gdk.Drawable"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.gdk.DragContext</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gdkdisplaymanager.html">Prev</a> </td><th width="60%" align="center">The gtk.gdk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gdkdrawable.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.gdk.DragContext"><a name="class-gdkdragcontext"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.gdk.DragContext</h2><p>gtk.gdk.DragContext — an object containing the drag and drop context
data</p></div><div class="refsect1" title="Synopsis"><a name="id2929967"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.gdk.DragContext</span></span>(<span class="ooclass"><span class="classname"><PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gdkdragcontext.html#constructor-gdkdragcontext" title="Constructor">gtk.gdk.DragContext</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status">drag_status</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>action</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drop-reply" title="gtk.gdk.DragContext.drop_reply">drop_reply</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drop-finish" title="gtk.gdk.DragContext.drop_finish">drop_finish</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>success</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-get-selection" title="gtk.gdk.DragContext.drag_get_selection">drag_get_selection</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-find-window" title="gtk.gdk.DragContext.drag_find_window">drag_find_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-find-window-for-screen" title="gtk.gdk.DragContext.drag_find_window_for_screen">drag_find_window_for_screen</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-motion" title="gtk.gdk.DragContext.drag_motion">drag_motion</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dest_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>protocol</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>suggested_action</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>possible_actions</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-drop" title="gtk.gdk.DragContext.drag_drop">drag_drop</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-abort" title="gtk.gdk.DragContext.drag_abort">drag_abort</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--finish" title="gtk.gdk.DragContext.finish">finish</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>success</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>del_</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--get-source-widget" title="gtk.gdk.DragContext.get_source_widget">get_source_widget</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-widget" title="gtk.gdk.DragContext.set_icon_widget">set_icon_widget</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-pixmap" title="gtk.gdk.DragContext.set_icon_pixmap">set_icon_pixmap</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixmap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-pixbuf" title="gtk.gdk.DragContext.set_icon_pixbuf">set_icon_pixbuf</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-stock" title="gtk.gdk.DragContext.set_icon_stock">set_icon_stock</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-name" title="gtk.gdk.DragContext.set_icon_name">set_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-default" title="gtk.gdk.DragContext.set_icon_default">set_icon_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-drop-succeeded" title="gtk.gdk.DragContext.drag_drop_succeeded">drag_drop_succeeded</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3141834"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext">gtk.gdk.DragContext</a>
</pre></div><div class="refsect1" title="Attributes"><a name="id2909909"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table cellpadding="5" width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"action"</td><td valign="top">Read</td><td valign="top">the action chosen by the destination. One of:
<code class="literal">gtk.gdk.ACTION_COPY</code>,
<code class="literal">gtk.gdk.ACTION_MOVE</code>,
<code class="literal">gtk.gdk.ACTION_LINK</code>,
<code class="literal">gtk.gdk.ACTION_PRIVATE</code></td></tr><tr valign="top"><td valign="top">"actions"</td><td valign="top">Read</td><td valign="top">a bitmask of actions proposed by the source when
<code class="literal">suggested_action</code> is
<code class="literal">gtk.gdk.ACTION_ASK</code>. A combination of:
<code class="literal">gtk.gdk.ACTION_COPY</code>,
<code class="literal">gtk.gdk.ACTION_MOVE</code>,
<code class="literal">gtk.gdk.ACTION_LINK</code>,
<code class="literal">gtk.gdk.ACTION_PRIVATE</code></td></tr><tr valign="top"><td valign="top">"dest_window"</td><td valign="top">Read</td><td valign="top">the destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of
this drag.</td></tr><tr valign="top"><td valign="top">"is_source"</td><td valign="top">Read</td><td valign="top">if True the context is used on the source side.</td></tr><tr valign="top"><td valign="top">"protocol"</td><td valign="top">Read</td><td valign="top">the DND protocol which governs this drag - one of:
<code class="literal">gtk.gdk.DRAG_PROTO_MOTIF</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_XDND</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_ROOTWIN</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_NONE</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_WIN32_DROPFILES</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_OLE2</code>,
<code class="literal">gtk.gdk.DRAG_PROTO_LOCAL</code></td></tr><tr valign="top"><td valign="top">"source_window"</td><td valign="top">Read</td><td valign="top">the source <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of
this drag.</td></tr><tr valign="top"><td valign="top">"start_time"</td><td valign="top">Read</td><td valign="top">a timestamp recording the start time of this
drag.</td></tr><tr valign="top"><td valign="top">"suggested_action"</td><td valign="top">Read</td><td valign="top">the action suggested by the source. One of:
<code class="literal">gtk.gdk.ACTION_DEFAULT</code>,
<code class="literal">gtk.gdk.ACTION_COPY</code>,
<code class="literal">gtk.gdk.ACTION_MOVE</code>,
<code class="literal">gtk.gdk.ACTION_LINK</code>,
<code class="literal">gtk.gdk.ACTION_PRIVATE</code>,
<code class="literal">gtk.gdk.ACTION_ASK</code></td></tr><tr valign="top"><td valign="top">"targets"</td><td valign="top">Read</td><td valign="top">a list of targets offered by the source.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="Description"><a name="id2945699"></a><h2>Description</h2><p>A <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a>
holds information about a drag in progress. It is used for both source and
destination. A <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a>
can be created using the <a class="link" href="class-gdkdragcontext.html#constructor-gdkdragcontext" title="Constructor">gtk.gdk.DragContext</a>()
constructor but since there is no way to set its attributes the new object
is not much use. Useful <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a>
objects are created as a result of the <a class="link" href="class-gdkwindow.html#method-gdkwindow--drag-begin" title="gtk.gdk.Window.drag_begin"><code class="methodname">gtk.gdk.Window.drag_begin</code>()</a>
or the <a class="link" href="class-gtkwidget.html#method-gtkwidget--drag-begin" title="gtk.Widget.drag_begin"><code class="methodname">gtk.Widget.drag_begin</code>()</a>
methods.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gdkdragcontext"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.gdk.DragContext</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a></td></tr></tbody></table><p>Creates a new <a class="link" href="class-gdkdragcontext.html" title="gtk.gdk.DragContext"><code class="classname">gtk.gdk.DragContext</code></a>
object.</p></div><div class="refsect1" title="Methods"><a name="id2992538"></a><h2>Methods</h2><div class="refsect2" title="gtk.gdk.DragContext.drag_status"><a name="method-gdkdragcontext--drag-status"></a><h3>gtk.gdk.DragContext.drag_status</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_status</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>action</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>action</code></strong> :</span></p></td><td>a drag action that will be taken when a drop
happens</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the timestamp for this
action</td></tr></tbody></table><p>The <code class="methodname">drag_status</code>() method sets the
specified <em class="parameter"><code>action</code></em> to be taken when a drop happens. The
value of <em class="parameter"><code>action</code></em> is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_DEFAULT</code></span></p></td><td></td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_COPY</code></span></p></td><td>Copy the data.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_MOVE</code></span></p></td><td>Move the data, i.e. first copy it, then delete it from
the source using the DELETE target of the X selection protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_LINK</code></span></p></td><td>Add a link to the data. Note that this is only useful
if source and destination agree on what it means.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_PRIVATE</code></span></p></td><td>Special action which tells the source that the
destination will do something that the source doesn't understand.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.ACTION_ASK</code></span></p></td><td>Ask the user what to do with the data.</td></tr></tbody></table><p>The time the action occurred is specified by
<em class="parameter"><code>time</code></em>. This method is called by the drag destination
in response to <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-motion" title="gtk.gdk.DragContext.drag_motion"><code class="methodname">drag_motion</code>()</a>
called by the drag source.
</p></div><div class="refsect2" title="gtk.gdk.DragContext.drop_reply"><a name="method-gdkdragcontext--drop-reply"></a><h3>gtk.gdk.DragContext.drop_reply</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drop_reply</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>ok</code></strong> :</span></p></td><td>if <code class="literal">True</code> the drop is accepted
by the destination</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the timestamp</td></tr></tbody></table><p>The <code class="methodname">drop_reply</code>() method determines if
the drop is accepted or rejected according to the value specified by
<em class="parameter"><code>ok</code></em>. If <em class="parameter"><code>ok</code></em> is
<code class="literal">True</code> the drop is accepted. <em class="parameter"><code>time</code></em>
specifies the time that the drop reply occurred. This method is called by
the drag destination when a drop is initiated by the drag source.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drop_finish"><a name="method-gdkdragcontext--drop-finish"></a><h3>gtk.gdk.DragContext.drop_finish</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drop_finish</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>success</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>success</code></strong> :</span></p></td><td>if True the data was
received</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the time of the finish</td></tr></tbody></table><p>The <code class="methodname">drop_finish</code>() method ends a drag
operation and indicates if the drop was successful by setting the value of
<em class="parameter"><code>success</code></em>. <em class="parameter"><code>time</code></em> indicates the
time of the drop finish. This method is called by the drag
destination.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_get_selection"><a name="method-gdkdragcontext--drag-get-selection"></a><h3>gtk.gdk.DragContext.drag_get_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_get_selection</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the selection atom</td></tr></tbody></table><p>The <code class="methodname">drag_get_selection</code>() method returns
the selection atom for the current source window.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_find_window"><a name="method-gdkdragcontext--drag-find-window"></a><h3>gtk.gdk.DragContext.drag_find_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_find_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>drag_window</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x_root</code></strong> :</span></p></td><td>the x position of the pointer in root
coordinates.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y_root</code></strong> :</span></p></td><td>the y position of the pointer in root
coordinates.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the drag destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
the drag protocol</td></tr></tbody></table><p>The <code class="methodname">drag_find_window</code>() method returns a
2-tuple containing the drag destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
the drag protocol being used. The drag protocol is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_MOTIF</code></span></p></td><td>The Motif DND protocol. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_XDND</code></span></p></td><td>The Xdnd protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_ROOTWIN</code></span></p></td><td>An extension to the Xdnd protocol for unclaimed root
window drops. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_NONE</code></span></p></td><td>no protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_WIN32_DROPFILES</code></span></p></td><td>The simple WM_DROPFILES protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_OLE2</code></span></p></td><td>The complex OLE2 DND protocol (not
implemented).</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_LOCAL</code></span></p></td><td>Intra-application DND.</td></tr></tbody></table><p><em class="parameter"><code>drag_window</code></em> is a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
<em class="parameter"><code>x_root</code></em> and <em class="parameter"><code>y_root</code></em> specify the
location of the mouse pointer in the root window.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_find_window_for_screen"><a name="method-gdkdragcontext--drag-find-window-for-screen"></a><h3>gtk.gdk.DragContext.drag_find_window_for_screen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_find_window_for_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>drag_window</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x_root</code></strong> :</span></p></td><td>the x position of the pointer in root
coordinates.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y_root</code></strong> :</span></p></td><td>the y position of the pointer in root
coordinates.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the drag destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
the drag protocol</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">drag_find_window_for_screen</code>()
method returns a 2-tuple containing the drag destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
the drag protocol being used. The drag protocol is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_MOTIF</code></span></p></td><td>The Motif DND protocol. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_XDND</code></span></p></td><td>The Xdnd protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_ROOTWIN</code></span></p></td><td>An extension to the Xdnd protocol for unclaimed root
window drops. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_NONE</code></span></p></td><td>no protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_WIN32_DROPFILES</code></span></p></td><td>The simple WM_DROPFILES protocol.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_OLE2</code></span></p></td><td>The complex OLE2 DND protocol (not
implemented).</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.DRAG_PROTO_LOCAL</code></span></p></td><td>Intra-application DND.</td></tr></tbody></table><p><em class="parameter"><code>drag_window</code></em> is a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> and
<em class="parameter"><code>x_root</code></em> and <em class="parameter"><code>y_root</code></em> specify the
location of the mouse pointer in the root window.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_motion"><a name="method-gdkdragcontext--drag-motion"></a><h3>gtk.gdk.DragContext.drag_motion</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_motion</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dest_window</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>protocol</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_root</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>suggested_action</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>possible_actions</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>dest_window</code></strong> :</span></p></td><td>the destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> the
drag is moving over</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>protocol</code></strong> :</span></p></td><td>the drag protocol in use</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x_root</code></strong> :</span></p></td><td>the x root coordinate of the mouse
pointer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y_root</code></strong> :</span></p></td><td>the y root coordinate of the mouse
pointer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>suggested_action</code></strong> :</span></p></td><td>the suggest drag action</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>possible_actions</code></strong> :</span></p></td><td>the possible drag actions</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the timestamp of the drag
motion</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>True if there is a drag destination window and
the drag has paused or a drop has occurred.</td></tr></tbody></table><p>The <code class="methodname">drag_motion</code>() method updates the
drag context when the pointer moves or the set of actions changes. This
method is called by the drag source. <em class="parameter"><code>dest_window</code></em>
specifies the drag destination <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>;
<em class="parameter"><code>protocol</code></em> specifies the drag protocol being used (see
the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-find-window" title="gtk.gdk.DragContext.drag_find_window"><code class="methodname">drag_find_window</code>()</a>
method for details); <em class="parameter"><code>x_root</code></em> and
<em class="parameter"><code>y_root</code></em> specify the root window coordinates of the
mouse pointer; <em class="parameter"><code>suggested_action</code></em> specifies the
suggested drag action (see the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status"><code class="methodname">drag_status</code>()</a>
method for more detail); possible_actions specifies the possible drag
actions for the drag (see the <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--drag-status" title="gtk.gdk.DragContext.drag_status"><code class="methodname">drag_status</code>()</a>
method for more detail); and, <em class="parameter"><code>time</code></em> specifies the
timestamp of the drag motion.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_drop"><a name="method-gdkdragcontext--drag-drop"></a><h3>gtk.gdk.DragContext.drag_drop</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_drop</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the timestamp of the drag
drop.</td></tr></tbody></table><p>The <code class="methodname">drag_drop</code>() method initiates a drop
on the current drag destination at the time specified by
<em class="parameter"><code>time</code></em>. This method is called by the drag
source.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_abort"><a name="method-gdkdragcontext--drag-abort"></a><h3>gtk.gdk.DragContext.drag_abort</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_abort</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the time of the drag abort
operation</td></tr></tbody></table><p>The <code class="methodname">drag_abort</code>() method aborts the
current drag operation at the specified <em class="parameter"><code>time</code></em>. No drop
operation is initiated. This method is called by the drag source.</p></div><div class="refsect2" title="gtk.gdk.DragContext.finish"><a name="method-gdkdragcontext--finish"></a><h3>gtk.gdk.DragContext.finish</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">finish</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>success</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>del_</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>time</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>success</code></strong> :</span></p></td><td>if <code class="literal">True</code> the drop was
completed</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>del_</code></strong> :</span></p></td><td>if <code class="literal">True</code> the drag source
should delete the source data</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>time</code></strong> :</span></p></td><td>the time of the drag finish
operation.</td></tr></tbody></table><p>The <code class="methodname">finish</code>() method informs the drag
source that the drop is finished, and that the data of the drag will no
longer be required. If <em class="parameter"><code>success</code></em> is
<code class="literal">True</code> the drag drop completed successfully; if
<em class="parameter"><code>del_</code></em> is <code class="literal">True</code> the source data
should be deleted; <em class="parameter"><code>time</code></em> is the timestamp of the
finish operation. This method is called by the drag destination.</p></div><div class="refsect2" title="gtk.gdk.DragContext.get_source_widget"><a name="method-gdkdragcontext--get-source-widget"></a><h3>gtk.gdk.DragContext.get_source_widget</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_source_widget</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the source <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> if the
drag is within the same application or <code class="literal">None</code>
otherwise.</td></tr></tbody></table><p>The <code class="methodname">get_source_widget</code>() method returns
the source <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> if the
drag is within the application; otherwise <code class="literal">None</code> is
returned.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_widget"><a name="method-gdkdragcontext--set-icon-widget"></a><h3>gtk.gdk.DragContext.set_icon_widget</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_widget</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>a toplevel window to use as an
icon.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_x</code></strong> :</span></p></td><td>the X offset within
<em class="parameter"><code>widget</code></em> of the hotspot.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_y</code></strong> :</span></p></td><td>the Y offset within
<em class="parameter"><code>widget</code></em> of the hotspot.</td></tr></tbody></table><p>The <code class="methodname">set_icon_widget</code>() method changes
the icon for a drag source to the specified <em class="parameter"><code>widget</code></em>
with its hot spot at the offset specified by <em class="parameter"><code>hot_x</code></em>
and <em class="parameter"><code>hot_y</code></em>. <code class="literal">PyGTK</code> will not destroy
the icon, so if you don't want it to persist, you should connect to the
"drag_end" signal and destroy it yourself.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_pixmap"><a name="method-gdkdragcontext--set-icon-pixmap"></a><h3>gtk.gdk.DragContext.set_icon_pixmap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_pixmap</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixmap</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>colormap</code></strong> :</span></p></td><td>the colormap of the icon</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pixmap</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a> image
data for the icon</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>mask</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a>
transparency mask for the icon</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_x</code></strong> :</span></p></td><td>the X offset within
<em class="parameter"><code>pixmap</code></em> of the hotspot.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_y</code></strong> :</span></p></td><td>the Y offset within
<em class="parameter"><code>pixmap</code></em> of the hotspot.</td></tr></tbody></table><p>The <code class="methodname">set_icon_pixmap</code>() method sets
<em class="parameter"><code>pixmap</code></em> as the icon for the drag.
<em class="parameter"><code>mask</code></em> is a bitmap mask for
<em class="parameter"><code>pixmap</code></em> and <em class="parameter"><code>hot_x</code></em> and
<em class="parameter"><code>hot_y</code></em> specify the offset of the hot spot in
<em class="parameter"><code>pixmap</code></em>. In general, <a class="link" href="class-gdkdragcontext.html#method-gdkdragcontext--set-icon-pixbuf" title="gtk.gdk.DragContext.set_icon_pixbuf"><code class="function">gtk.gdk.DragContext.set_icon_pixbuf()</code></a>
will be more convenient to use.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_pixbuf"><a name="method-gdkdragcontext--set-icon-pixbuf"></a><h3>gtk.gdk.DragContext.set_icon_pixbuf</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_pixbuf</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pixbuf</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>pixbuf</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a> to
use as the drag icon.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_x</code></strong> :</span></p></td><td>the X offset within
<em class="parameter"><code>pixbuf</code></em> of the hotspot.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_y</code></strong> :</span></p></td><td>the Y offset within
<em class="parameter"><code>pixbuf</code></em> of the hotspot.</td></tr></tbody></table><p>The <code class="methodname">set_icon_pixbuf</code>() method sets
<em class="parameter"><code>pixbuf</code></em> as the icon for the drag.
<em class="parameter"><code>hot_x</code></em> and <em class="parameter"><code>hot_y</code></em> specify the
offset of the hot spot within <em class="parameter"><code>pixbuf</code></em>.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_stock"><a name="method-gdkdragcontext--set-icon-stock"></a><h3>gtk.gdk.DragContext.set_icon_stock</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_stock</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>stock_id</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>stock_id</code></strong> :</span></p></td><td>the ID of the stock icon to use for the
drag.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_x</code></strong> :</span></p></td><td>the X offset within the icon of the
hotspot.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_y</code></strong> :</span></p></td><td>the Y offset within the icon of the
hotspot.</td></tr></tbody></table><p>The <code class="methodname">set_icon_stock</code>() method sets the
the icon for a given drag from a stock ID specified by
<em class="parameter"><code>stock_id</code></em>. <em class="parameter"><code>hot_x</code></em> and
<em class="parameter"><code>hot_y</code></em> specify the offset of the hot spot within the
stock icon.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_name"><a name="method-gdkdragcontext--set-icon-name"></a><h3>gtk.gdk.DragContext.set_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>hot_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>icon_name</code></strong> :</span></p></td><td>the name of the icon to use for the
drag.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_x</code></strong> :</span></p></td><td>the X offset within the icon of the
hotspot.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>hot_y</code></strong> :</span></p></td><td>the Y offset within the icon of the
hotspot.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">set_icon_name</code>() method sets the the
icon for a given drag from the named themed icon specified by
<em class="parameter"><code>icon_name</code></em>. <em class="parameter"><code>hot_x</code></em> and
<em class="parameter"><code>hot_y</code></em> specify the offset of the hot spot within the
stock icon. See the docs for <a class="link" href="class-gtkicontheme.html" title="gtk.IconTheme"><code class="classname">gtk.IconTheme</code></a> for
more information. Note that the size of the icon depends on the icon theme
(the icon is loaded at the symbolic size
<code class="literal">gtk.ICON_SIZE_DND</code>), thus <em class="parameter"><code>hot_x</code></em> and
<em class="parameter"><code>hot_y</code></em> have to be used with care.</p></div><div class="refsect2" title="gtk.gdk.DragContext.set_icon_default"><a name="method-gdkdragcontext--set-icon-default"></a><h3>gtk.gdk.DragContext.set_icon_default</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_default</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">set_icon_default</code>() method sets the
icon for the drag to the default icon.</p></div><div class="refsect2" title="gtk.gdk.DragContext.drag_drop_succeeded"><a name="method-gdkdragcontext--drag-drop-succeeded"></a><h3>gtk.gdk.DragContext.drag_drop_succeeded</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">drag_drop_succeeded</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the drop was
successful.</td></tr></tbody></table><p>The <code class="methodname">drag_drop_succeeded</code>() method
returns <code class="literal">True</code> if the dropped data has been successfully
transferred. This method is intended to be used while handling a
<code class="literal">gtk.gdk.DROP_FINISHED</code> event, its return value is
meaningless at other times.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gdkdisplaymanager.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gdk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gdkdrawable.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.gdk.DisplayManager </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.gdk.Drawable</td></tr></table></div></body></html>
|