gtk-selections.html

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

CLASS="REFSECT2"
><A
NAME="AEN6527"
></A
><H3
><A
NAME="GTK-TARGET-LIST-ADD-TABLE"
></A
>gtk_target_list_add_table ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_target_list_add_table       (<A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
> *list,
                                             const <A
HREF="gtk-selections.html#GTKTARGETENTRY"
>GtkTargetEntry</A
> *targets,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> ntargets);</PRE
></TD
></TR
></TABLE
><P
>Add a table of <A
HREF="gtk-selections.html#GTKTARGETENTRY"
>GtkTargetEntry</A
> into a target list</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6536"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
></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 table of <A
HREF="gtk-selections.html#GTKTARGETENTRY"
>GtkTargetEntry</A
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ntargets</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>number of targets in the table
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6555"
></A
><H3
><A
NAME="GTK-TARGET-LIST-REMOVE"
></A
>gtk_target_list_remove ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_target_list_remove          (<A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
> *list,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> target);</PRE
></TD
></TR
></TABLE
><P
>Remove a target from a target list</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6562"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
></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 interned atom representing the target
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6576"
></A
><H3
><A
NAME="GTK-TARGET-LIST-FIND"
></A
>gtk_target_list_find ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gtk_target_list_find            (<A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
> *list,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> target,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *info);</PRE
></TD
></TR
></TABLE
><P
>Look up a given target in a <A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6586"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtk-selections.html#GTKTARGETLIST"
>GtkTargetList</A
></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"
>an interned atom representing the target to search for</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>info</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a pointer to the location to store application info for target</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the target was found, otherwise <TT
CLASS="LITERAL"
>FALSE</TT
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6610"
></A
><H3
><A
NAME="GTK-SELECTION-OWNER-SET"
></A
>gtk_selection_owner_set ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_selection_owner_set         (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> selection,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> time);</PRE
></TD
></TR
></TABLE
><P
>Claim ownership of a given selection for a particular widget,
or, if <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> is <TT
CLASS="LITERAL"
>NULL</TT
>, release ownership of the selection.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6621"
></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
>, or <TT
CLASS="LITERAL"
>NULL</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>selection</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an interned atom representing the selection to claim</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 time stamp for claiming the selection</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeded
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6645"
></A
><H3
><A
NAME="GTK-SELECTION-ADD-TARGET"
></A
>gtk_selection_add_target ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_selection_add_target        (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> selection,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> target,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> info);</PRE
></TD
></TR
></TABLE
><P
>Add specified target to the list of supported targets for a 
given widget and selection.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6654"
></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 GtkTarget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>selection</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the selection</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"
>target to add.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>info</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A unsigned integer which will be passed back to the application.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6676"
></A
><H3
><A
NAME="GTK-SELECTION-ADD-TARGETS"
></A
>gtk_selection_add_targets ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_selection_add_targets       (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> selection,
                                             const <A
HREF="gtk-selections.html#GTKTARGETENTRY"
>GtkTargetEntry</A
> *targets,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> ntargets);</PRE
></TD
></TR
></TABLE
><P
>Add a table of targets to the list of supported targets
for a given widget and selection.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6685"
></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
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>selection</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the selection</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"
>a table of targets to add</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ntargets</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>number of entries in <TT
CLASS="PARAMETER"
><I
>targets</I
></TT
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6708"
></A
><H3
><A
NAME="GTK-SELECTION-CONVERT"
></A
>gtk_selection_convert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_selection_convert           (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> selection,
                                             <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
>Request the contents of a selection. When received, 
a "selection_received" signal will be generated.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6718"
></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 which acts as requestor</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>selection</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Which selection to get</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"
>Form of information desired (e.g., STRING)</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"
>Time of request (usually of triggering event)
       In emergency, you could use GDK_CURRENT_TIME</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>TRUE if requested succeeded. FALSE if we could not process
          request. (e.g., there was already a request in process for
          this widget).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6743"
></A
><H3
><A
NAME="GTK-SELECTION-DATA-SET"
></A
>gtk_selection_data_set ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_selection_data_set          (<A
HREF="gtkwidget.html#GTKSELECTIONDATA"
>GtkSelectionData</A
> *selection_data,
                                             <A
HREF=../gdk/gdk-properties-and-atoms.html#GDKATOM
>GdkAtom</A> type,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> format,
                                             <A
HREF=../glib/glib-basic-types.html#GUCHAR
>guchar</A> *data,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> length);</PRE
></TD
></TR
></TABLE
><P
>Store new data into a GtkSelectionData object. Should
_only_ by called from a selection handler callback.
Null terminates the stored data.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6753"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY