gtk-signals.html

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

><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal name.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the recursion depth of emissions of this signal for this
object.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8345"
></A
><H3
><A
NAME="GTK-SIGNAL-EMIT-STOP"
></A
>gtk_signal_emit_stop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emit_stop            (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> signal_id);</PRE
></TD
></TR
></TABLE
><P
>This function aborts a signal's current emission.</P
><P
>It will prevent the default method from running,
if the signal was GTK_RUN_LAST and you connected
normally (i.e. without the "after" flag).</P
><P
>It will print a warning if used on a signal which
isn't being emitted.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8355"
></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
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object whose signal handlers you wish to stop.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal identifier, as returned by <A
HREF="gtk-signals.html#GTK-SIGNAL-LOOKUP"
>gtk_signal_lookup</A
>().
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8369"
></A
><H3
><A
NAME="GTK-SIGNAL-EMIT-STOP-BY-NAME"
></A
>gtk_signal_emit_stop_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emit_stop_by_name    (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>This function aborts a signal's current emission.</P
><P
>It is just like
<A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT-STOP"
>gtk_signal_emit_stop</A
>()
except it will lookup the signal id for you.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8378"
></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
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object whose signal handlers you wish to stop.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the signal you wish to stop.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8391"
></A
><H3
><A
NAME="GTK-SIGNAL-CONNECT"
></A
>gtk_signal_connect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gtk_signal_connect              (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-types.html#GTKSIGNALFUNC"
>GtkSignalFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> func_data);</PRE
></TD
></TR
></TABLE
><P
>Attach a function pointer and user data to a signal for
a particular object.</P
><P
>The GtkSignalFunction takes a <SPAN
CLASS="STRUCTNAME"
>GtkObject</SPAN
> as its first parameter.
It will be the same object as the one you're connecting
the hook to.  The func_data will be passed as the last parameter
to the hook.</P
><P
>All else being equal, signal handlers are invoked in the order 
connected (see <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>() for the other details of
which order things are called in).</P
><P
>Here is how one passes an integer as user data,
for when you just want to specify a constant int
as parameter to your function:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN8406"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static void button_clicked_int(GtkButton* button, gpointer func_data)
{
	g_print("button pressed: <TT
CLASS="LITERAL"
>d</TT
>\n", GPOINTER_TO_INT(func_data));
}

/* By calling this function, you will make the g_print above
 * execute, printing the number passed as `to_print'. */
static void attach_print_signal(GtkButton* button, gint to_print)
{
	gtk_signal_connect(GTK_OBJECT(button), "clicked",
		GTK_SIGNAL_FUNC(button_clicked_int),
		GINT_TO_POINTER(to_print));
}</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8409"
></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
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object associated with the signal, e.g. if a button
is getting pressed, this is that button.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>name of the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>function pointer to attach to the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>value to pass as to your function (through the marshaller).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the connection id.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8434"
></A
><H3
><A
NAME="GTK-SIGNAL-CONNECT-AFTER"
></A
>gtk_signal_connect_after ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gtk_signal_connect_after        (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-types.html#GTKSIGNALFUNC"
>GtkSignalFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> func_data);</PRE
></TD
></TR
></TABLE
><P
>Attach a function pointer and user data to a signal
so that this handler will be called after the other handlers.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8444"
></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
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object associated with the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>name of the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>function pointer to attach to the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>value to pass as to your function (through the marshaller).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the unique identifier for this attachment:  the connection id.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8469"
></A
><H3
><A
NAME="GTK-SIGNAL-CONNECT-OBJECT"
></A
>gtk_signal_connect_object ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gtk_signal_connect_object       (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-types.html#GTKSIGNALFUNC"
>GtkSignalFunc</A
> func,
                                             <A
HREF="gtkobject.html"
>GtkObject</A
> *slot_object);</PRE
></TD
></TR
></TABLE
><P
>This function is for registering a callback that will
call another object's callback.  That is,
instead of passing the object which is responsible
for the event as the first parameter of the callback,
it is switched with the user data (so the object which emits
the signal will be the last parameter, which is where the
user data usually is).</P
><P
>This is useful for passing a standard function in as a callback.
For example, if you wanted a button's press to <A
HREF="gtkwidget.html#GTK-WIDGET-SHOW"
>gtk_widget_show</A
>()
some widget, you could write:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN8481"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>gtk_signal_connect_object(button, "clicked", gtk_widget_show, window);</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8483"
></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
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which emits the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the function to callback.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>slot_object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object to pass as the first parameter to func.
(Though