Commit b3fcc83a authored by GMT 2000  Tony Gale's avatar GMT 2000 Tony Gale Committed by Tony Gale
Browse files

DND updates

Tue Dec  5 13:17:53 GMT 2000  Tony Gale <gale@gtk.org>

        * docs/tutorial/gtk-tut.sgml: DND updates
parent f1046d9a
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
Tue Dec 5 13:17:53 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: DND updates
2000-12-05 Alexander Larsson <alla@lysator.liu.se> 2000-12-05 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3): * gdk/linux-fb/gdkdrawable-fb2.c (gdk_fb_draw_drawable_3):
......
...@@ -12871,7 +12871,7 @@ target</emphasis>) come into play only in your request and received ...@@ -12871,7 +12871,7 @@ target</emphasis>) come into play only in your request and received
data handler functions. The term <emphasis>selection target</emphasis> data handler functions. The term <emphasis>selection target</emphasis>
is somewhat misleading. It is a term adapted from GTK+ selection is somewhat misleading. It is a term adapted from GTK+ selection
(cut/copy and paste). What <emphasis>selection target</emphasis> (cut/copy and paste). What <emphasis>selection target</emphasis>
actually means is the data's format type (ie GdkAtom, integer, or actually means is the data's format type (i.e. GdkAtom, integer, or
string) that being sent or received. Your request data handler function string) that being sent or received. Your request data handler function
needs to specify the type (<emphasis>selection target</emphasis>) of needs to specify the type (<emphasis>selection target</emphasis>) of
data that it sends out and your received data handler needs to handle data that it sends out and your received data handler needs to handle
...@@ -12884,6 +12884,7 @@ received.</para> ...@@ -12884,6 +12884,7 @@ received.</para>
<sect1 id="sec-DragAndDropFunctions"> <sect1 id="sec-DragAndDropFunctions">
<title>Functions</title> <title>Functions</title>
   
<!-- ----------------------------------------------------------------- -->
<sect2 id="sec-DNDSourceWidgets"> <sect2 id="sec-DNDSourceWidgets">
<title>Setting up the source widget</title> <title>Setting up the source widget</title>
   
...@@ -12942,60 +12943,100 @@ void gtk_drag_source_unset( GtkWidget *widget ); ...@@ -12942,60 +12943,100 @@ void gtk_drag_source_unset( GtkWidget *widget );
   
</sect2> </sect2>
   
<!-- ----------------------------------------------------------------- -->
<sect2 id="sec-SignalsOnSourceWidgets"> <sect2 id="sec-SignalsOnSourceWidgets">
<title>Signals on the source widget:</title> <title>Signals on the source widget:</title>
   
<itemizedlist> <para>The source widget is sent the following signals during a
<listitem><simpara> drag_begin - prototype: void (*drag_begin)(GtkWidget drag-and-drop operation.</para>
*widget, GdkDragContext *dc, gpointer data)</simpara>
</listitem> <table pgwide="1">
<title>Source widget signals</title>
<listitem><simpara> drag_motion - prototype gboolean <tgroup cols="2">
(*drag_motion)(GtkWidget *widget, GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</simpara> <colspec colname="Name" colwidth="150">
</listitem> <colspec colname="Prototype">
<tbody>
<listitem><simpara> drag_data_get - prototype void <row>
(*drag_data_get)(GtkWidget *widget, GdkDragContext *dc, GtkSelectionData *selection_data, guint info, guint t, gpointer data)</simpara> <entry align="left" valign="middle">drag_begin</entry>
</listitem> <entry align="left" valign="middle"><literal>void (*drag_begin)(GtkWidget *widget,
GdkDragContext *dc, gpointer data)</literal></entry>
<listitem><simpara> drag_data_delete - prototype void </row>
(*drag_data_delete)(GtkWidget *widget, GdkDragContext *dc, gpointer data)</simpara> <row>
</listitem> <entry align="left" valign="middle">drag_motion</entry>
<entry align="left" valign="middle"><literal>gboolean (*drag_motion)(GtkWidget *widget,
<listitem><simpara> drag_drop - prototype gboolean GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</literal></entry>
(*drag_drop)(GtkWidget *widget, GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</simpara> </row>
</listitem> <row>
<entry align="left" valign="middle">drag_data_get</entry>
<listitem><simpara> drag_end - prototype void (*drag_end)(GtkWidget *widget, GdkDragContext *dc, gpointer data)</simpara> <entry align="left" valign="middle"><literal>void (*drag_data_get)(GtkWidget *widget,
</listitem> GdkDragContext *dc, GtkSelectionData *selection_data, guint info, guint t, gpointer data)</literal></entry>
</itemizedlist> </row>
<row>
<entry align="left" valign="middle">drag_data_delete</entry>
<entry align="left" valign="middle"><literal>void (*drag_data_delete)(GtkWidget *widget,
GdkDragContext *dc, gpointer data)</literal></entry>
</row>
<row>
<entry align="left" valign="middle">drag_drop</entry>
<entry align="left" valign="middle"><literal>gboolean (*drag_drop)(GtkWidget *widget,
GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</literal></entry>
</row>
<row>
<entry align="left" valign="middle">drag_end</entry>
<entry align="left" valign="middle"><literal>void (*drag_end)(GtkWidget *widget,
GdkDragContext *dc, gpointer data)</literal></entry>
</row>
</tbody>
</tgroup>
</table>
   
</sect2> </sect2>
   
<!-- ----------------------------------------------------------------- -->
<sect2 id="sec-DNDDestWidgets"> <sect2 id="sec-DNDDestWidgets">
<title>Setting up a destination widget:</title> <title>Setting up a destination widget:</title>
   
<itemizedlist> <para> <literal> gtk_drag_dest_set()</literal> specifies
<listitem><simpara> <literal> gtk_drag_dest_set()</literal> specifies that this widget can receive drops and specifies what types of drops it
that this widget can recieve drops and specifies what types of drops it can receive.</para>
can recieve.</simpara>
</listitem>
   
<listitem><simpara> <literal> gtk_drag_dest_unset()</literal> specifies <para> <literal> gtk_drag_dest_unset()</literal> specifies
that the widget can no longer recieve drops.</simpara> that the widget can no longer receive drops.</para>
</listitem>
</itemizedlist> <programlisting role="C">
void gtk_drag_dest_set( GtkWidget *widget,
GtkDestDefaults flags,
const GtkTargetEntry *targets,
gint n_targets,
GdkDragAction actions );
void gtk_drag_dest_unset( GtkWidget *widget );
</programlisting>
   
</sect2> </sect2>
   
<!-- ----------------------------------------------------------------- -->
<sect2 id="sec-SignalsOnDestWidgets"> <sect2 id="sec-SignalsOnDestWidgets">
<title>Signals on the destination widget:</title> <title>Signals on the destination widget:</title>
   
<itemizedlist> <para>The destination widget is sent the following signals during a
<listitem><simpara> drag_data_received - prototype: void (*drag_data_received)(GtkWidget *widget, GdkDragContext drag-and-drop operation.</para>
*dc, gint x, gint y, GtkSelectionData *selection_data, guint info, guint t, gpointer data)</simpara>
</listitem> <table pgwide="1">
</itemizedlist> <title>Destination widget signals</title>
<tgroup cols="2">
<colspec colname="Name" colwidth="150">
<colspec colname="Prototype">
<tbody>
<row>
<entry align="left" valign="middle">drag_data_received</entry>
<entry align="left" valign="middle"><literal>void (*drag_data_received)(GtkWidget *widget,
GdkDragContext *dc, gint x, gint y, GtkSelectionData *selection_data, guint info, guint t,
gpointer data)</literal></entry>
</row>
</tbody>
</tgroup>
</table>
   
</sect2> </sect2>
</sect1> </sect1>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment