gtk-signals.html

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

WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal's identifying number, or 0 if no signal was found.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8165"
></A
><H3
><A
NAME="GTK-SIGNAL-NAME"
></A
>gtk_signal_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gtk_signal_name                 (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> signal_id);</PRE
></TD
></TR
></TABLE
><P
>Given the signal's identifier, find its name.</P
><P
>Two different signals may have the same name, if they have differing types.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8173"
></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
>signal_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal's identifying number.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal name, or NULL if the signal number was invalid.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8186"
></A
><H3
><A
NAME="GTK-SIGNAL-EMIT"
></A
>gtk_signal_emit ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emit                 (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> signal_id,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Emit a signal.  This causes the default handler and user-defined
handlers to be run.</P
><P
>Here is what <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>() does:</P
><P
>1.  Calls the default handler and the user-connected handlers.
The default handler will be called first if
GTK_RUN_FIRST is set, and last if GTK_RUN_LAST is set.</P
><P
>2.  Calls all handlers connected with the "after" flag set.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8197"
></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 that emits the signal.</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.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the parameters to the function, followed
by a pointer to the return type, if any.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8214"
></A
><H3
><A
NAME="GTK-SIGNAL-EMIT-BY-NAME"
></A
>gtk_signal_emit_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emit_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
>Emit a signal.  This causes the default handler and user-connected
handlers to be run.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8221"
></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 that 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
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the parameters to the function, followed
by a pointer to the return type, if any.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8238"
></A
><H3
><A
NAME="GTK-SIGNAL-EMITV"
></A
>gtk_signal_emitv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emitv                (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> signal_id,
                                             <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *params);</PRE
></TD
></TR
></TABLE
><P
>Emit a signal.  This causes the default handler and user-connected
handlers to be run.  This differs from <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>() by taking
an array of GtkArgs instead of using C's varargs mechanism.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8247"
></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 to emit the signal to.</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.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>params</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an array of GtkArgs, one for each parameter,
followed by one which is a pointer to the return type.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8264"
></A
><H3
><A
NAME="GTK-SIGNAL-EMITV-BY-NAME"
></A
>gtk_signal_emitv_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_emitv_by_name        (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-types.html#GTKARG"
>GtkArg</A
> *params);</PRE
></TD
></TR
></TABLE
><P
>Emit a signal by name.  This causes the default handler and user-connected
handlers to be run.  This differs from <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>() by taking
an array of GtkArgs instead of using C's varargs mechanism.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8273"
></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 to emit the signal to.</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
>params</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>an array of GtkArgs, one for each parameter,
followed by one which is a pointer to the return type.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8290"
></A
><H3
><A
NAME="GTK-SIGNAL-N-EMISSIONS"
></A
>gtk_signal_n_emissions ()</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_n_emissions          (<A
HREF="gtkobject.html"
>GtkObject</A
> *object,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> signal_id);</PRE
></TD
></TR
></TABLE
><P
>Find out the recursion depth of emissions for a particular type
of signal and object.  (So it will
always return 0 or 1 if GTK_RUN_NO_RECURSE is specified)
This is a way to avoid recursion:  you can see if
you are currently running in that signal handler and emit it only
if you are.</P
><P
>Another way to look at it is that this number increases
by one when #<A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>(), et al, are called,
and decreases by one when #<A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT"
>gtk_signal_emit</A
>() returns.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8302"
></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 with the signal handler.</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 id.</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="AEN8319"
></A
><H3
><A
NAME="GTK-SIGNAL-N-EMISSIONS-BY-NAME"
></A
>gtk_signal_n_emissions_by_name ()</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_n_emissions_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
>Find out the recursion depth of emissions for a particular type
of signal and object.  Just like <A
HREF="gtk-signals.html#GTK-SIGNAL-N-EMISSIONS"
>gtk_signal_n_emissions</A
>()
except it will lookup the signal id for you.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8328"
></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 with the signal handler.</TD
></TR
><TR