gtk-drag-and-drop.html

该压缩包包含了GTK+的大量API函数

NAME="GTK-DRAG-DEST-UNSET"
></A
>gtk_drag_dest_unset ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_dest_unset             (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Clear information about a drop destination set with
<A
HREF="gtk-drag-and-drop.html#GTK-DRAG-DEST-SET"
>gtk_drag_dest_set</A
>(). The widget will no longer receive
notification of drags.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7187"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkwidget.html"
>GtkWidget</A
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7197"
></A
><H3
><A
NAME="GTK-DRAG-FINISH"
></A
>gtk_drag_finish ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_finish                 (<A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A> *context,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> success,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> del,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> time);</PRE
></TD
></TR
></TABLE
><P
>Inform the drag source that the drop is finished, and
that the data of the drag will no longer be required.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7206"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>context</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the drag context.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>success</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a flag indicating whether the drop was succesful</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>del</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a flag indicating whether the source should delete the
      original data. (This should be <TT
CLASS="LITERAL"
>TRUE</TT
> for a move)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the timestamp from the "drag_data_drop" signal.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7228"
></A
><H3
><A
NAME="GTK-DRAG-GET-DATA"
></A
>gtk_drag_get_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_get_data               (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A> *context,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> target,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> time);</PRE
></TD
></TR
></TABLE
><P
>Get 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 <TT
CLASS="PARAMETER"
><I
>selection_data</I
></TT
>
signal parameter being negative. However, when <A
HREF="gtk-drag-and-drop.html#GTK-DRAG-GET-DATA"
>gtk_drag_get_data</A
>() 
is called implicitely because the <TT
CLASS="LITERAL"
>GTK_DRAG_DEFAULT_DROP</TT
> was set, 
then the widget will not receive notification of failed
drops.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7240"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the widget that will receive the "drag_data_received"
 signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>context</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the drag context</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>target</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the target (form of the data) to retrieve.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a timestamp for retrieving the data. This will
       generally be the time received in a "drag_data_motion"
       or "drag_data_drop" signal.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7261"
></A
><H3
><A
NAME="GTK-DRAG-GET-SOURCE-WIDGET"
></A
>gtk_drag_get_source_widget ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtkwidget.html"
>GtkWidget</A
>*  gtk_drag_get_source_widget      (<A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A> *context);</PRE
></TD
></TR
></TABLE
><P
>Determine the source widget for a drag.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7268"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>context</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a (destination side) drag context.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>if the drag is occurring within a single application,
          a pointer to the source widget. Otherwise, NULL.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7281"
></A
><H3
><A
NAME="GTK-DRAG-HIGHLIGHT"
></A
>gtk_drag_highlight ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_highlight              (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Draw 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.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7287"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a widget to highlight
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7296"
></A
><H3
><A
NAME="GTK-DRAG-UNHIGHLIGHT"
></A
>gtk_drag_unhighlight ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_unhighlight            (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Remove a highlight set by <A
HREF="gtk-drag-and-drop.html#GTK-DRAG-HIGHLIGHT"
>gtk_drag_highlight</A
>() from
a widget.
is called.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7303"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a widget to remove the highlight from.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7312"
></A
><H3
><A
NAME="GTK-DRAG-BEGIN"
></A
>gtk_drag_begin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A>* gtk_drag_begin              (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
> *targets,
                                             <A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGACTION
>GdkDragAction</A> actions,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event);</PRE
></TD
></TR
></TABLE
><P
>Initiate a drag on the source side. The function
only needs to be used when the application is
starting drags itself, and is not needed when
<A
HREF="gtk-drag-and-drop.html#GTK-DRAG-SOURCE-SET"
>gtk_drag_source_set</A
>() is used.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7324"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the source widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>targets</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The targets (data formats) in which the
 source can provide the data.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>actions</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A bitmask of the allowed drag actions for this
          drag.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The button the user clicked to start the drag.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The event that triggered the start of the
        drag. Usually</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The context for this drag.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7353"
></A
><H3
><A
NAME="GTK-DRAG-SET-ICON-WIDGET"
></A
>gtk_drag_set_icon_widget ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_set_icon_widget        (<A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A> *context,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> hot_x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> hot_y);</PRE
></TD
></TR
></TABLE
><P
>Change the icon for a widget to a given widget. GTK+
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
CLASS="INFORMALTABLE"
><A
NAME="AEN7362"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>context</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the context for a drag. (This must be called 
          with a  context for the source side of a drag)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A toplevel window to use as an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hot_x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The X offset within <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> of the hotspot.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hot_y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The Y offset within <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> of the hotspot.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7385"
></A
><H3
><A
NAME="GTK-DRAG-SET-ICON-PIXMAP"
></A
>gtk_drag_set_icon_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_drag_set_icon_pixmap        (<A
HREF=../gdk/gdk-drag-and-drop.html#GDKDRAGCONTEXT
>GdkDragContext</A> *context,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP
>GdkColormap</A> *colormap,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A> *pixmap,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKBITMAP
>GdkBitmap</A> *mask,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> hot_x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> hot_y);</PRE
></TD
></TR
></TABLE
><P
>Sets a given pixmap as the icon for a given drag.
GTK+ retains a reference count for the arguments, and 
will release them when they are no longer needed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7396"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>context</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the context for a drag. (This must be called 
          with a  context for the source side of a drag)</TD
></TR
><TR
><TD
WIDTH="20%"