gtk-signals.html

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

><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7981"
></A
><H3
><A
NAME="GTKSIGNALQUERY"
></A
>struct GtkSignalQuery</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkSignalQuery
{
  GtkType	   object_type;
  guint		   signal_id;
  const gchar	  *signal_name;
  guint		   is_user_signal : 1;
  GtkSignalRunType signal_flags;
  GtkType	   return_val;
  guint		   nparams;
  const GtkType	  *params;
};</PRE
></TD
></TR
></TABLE
><P
>This structure contains all the information about a particular
signal:  its name, the type it affects, the signature of the handlers,
and its unique identifying integer.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7986"
></A
><H3
><A
NAME="GTKSIGNALRUNTYPE"
></A
>enum GtkSignalRunType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum			/*&lt; flags &gt;*/
{
  GTK_RUN_FIRST      = 1 &lt;&lt; 0,
  GTK_RUN_LAST       = 1 &lt;&lt; 1,
  GTK_RUN_BOTH       = (GTK_RUN_FIRST | GTK_RUN_LAST),
  GTK_RUN_NO_RECURSE = 1 &lt;&lt; 2,
  GTK_RUN_ACTION     = 1 &lt;&lt; 3,
  GTK_RUN_NO_HOOKS   = 1 &lt;&lt; 4
} GtkSignalRunType;</PRE
></TD
></TR
></TABLE
><P
>These configure the signal's emission.  They control
whether the signal can be emitted recursively on an object
and
whether to run the default method before or after the user-defined handlers.</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>GTK_RUN_FIRST</DT
><DD
><P
>Run the default handler before the connected user-defined
handlers.</P
></DD
><DT
>GTK_RUN_LAST</DT
><DD
><P
>Run the default handler after the connected
user-defined handlers.
(Handlers registered as "after" always run after the default handler though)</P
></DD
><DT
>GTK_RUN_BOTH</DT
><DD
><P
>Run the default handler twice,
once before the user-defined handlers,
and
once after.</P
></DD
><DT
>GTK_RUN_NO_RECURSE</DT
><DD
><P
>Whether to prevent a handler or hook
from reemitting the signal from within itself.
Attempts to
emit the signal while it is running will result in the signal
emission being restarted once it is done with the current processing.</P
><P
>You must be
careful to avoid having two handlers endlessly reemitting signals,
<A
HREF="gtk-signals.html#GTK-SIGNAL-N-EMISSIONS"
>gtk_signal_n_emissions</A
>() can be helpful.</P
></DD
><DT
>GTK_RUN_ACTION</DT
><DD
><P
>The signal is an action you can 
invoke without any particular setup or cleanup.
The signal is treated no differently, but some
other code can determine if the signal is appropriate to
delegate to user control.  For example, key binding sets
only allow bindings of ACTION signals to keystrokes.</P
></DD
><DT
>GTK_RUN_NO_HOOKS</DT
><DD
><P
>This prevents the connection of emission hooks
to the signal.</P
></DD
></DL
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8018"
></A
><H3
><A
NAME="GTK-SIGNAL-INIT"
></A
>gtk_signal_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_signal_init                 (void);</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8023"
></A
><H3
><A
NAME="GTK-SIGNAL-NEW"
></A
>gtk_signal_new ()</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_new                  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-signals.html#GTKSIGNALRUNTYPE"
>GtkSignalRunType</A
> signal_flags,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> function_offset,
                                             <A
HREF="gtk-types.html#GTKSIGNALMARSHALLER"
>GtkSignalMarshaller</A
> marshaller,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> return_val,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nparams,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Create a new signal type.  (This is usually done in the
class initializer.)</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8036"
></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
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the event name for the signal, e.g. "clicked".</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a combination of GTK_RUN flags
specifying detail of when the default handler is to be invoked.
You should at least specify GTK_RUN_FIRST
or GTK_RUN_LAST.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of object this signal pertains to.
It will also pertain to derivers of this type automatically.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>function_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>How many bytes the function pointer is in
the class structure for this type.  Used to invoke a class
method generically.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshaller</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the function to translate between an array
of GtkArgs and the native calling convention.  Usually they
are identified just by the type of arguments they take:
for example, gtk_marshal_BOOL__STRING() describes a marshaller
which takes a string and returns a boolean value.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>return_val</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of return value, or GTK_TYPE_NONE for a signal
without a return value.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nparams</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of parameter the handlers may take.</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"
>a list of GTK_TYPE_*, one for each parameter.</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 id.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8080"
></A
><H3
><A
NAME="GTK-SIGNAL-NEWV"
></A
>gtk_signal_newv ()</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_newv                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-signals.html#GTKSIGNALRUNTYPE"
>GtkSignalRunType</A
> signal_flags,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> function_offset,
                                             <A
HREF="gtk-types.html#GTKSIGNALMARSHALLER"
>GtkSignalMarshaller</A
> marshaller,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> return_val,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nparams,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> *params);</PRE
></TD
></TR
></TABLE
><P
>Create a new signal type.  (This is usually done in a
class initializer.)</P
><P
>This function take the types as an array, instead of a list
following the arguments.  Otherwise the same as <A
HREF="gtk-signals.html#GTK-SIGNAL-NEW"
>gtk_signal_new</A
>().</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8096"
></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
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the signal to create.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>see <A
HREF="gtk-signals.html#GTK-SIGNAL-NEW"
>gtk_signal_new</A
>().</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of GtkObject to associate the signal with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>function_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>how many bytes the function pointer is in
the class structure for this type.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshaller</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>return_val</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type of the return value, or GTK_TYPE_NONE if
you don't want a return value.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nparams</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of parameters to the user-defined handlers.</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 GtkTypes, describing the prototype to
the callbacks.</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 id.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8138"
></A
><H3
><A
NAME="GTK-SIGNAL-LOOKUP"
></A
>gtk_signal_lookup ()</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_lookup               (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gtk-types.html#GTKTYPE"
>GtkType</A
> object_type);</PRE
></TD
></TR
></TABLE
><P
>Given the name of the signal and the type of object it connects
to, get the signal's identifying integer.  Emitting the signal
by number is somewhat faster than using the name each time.</P
><P
>It also tries the ancestors of the given type.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8147"
></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
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the signal's name, e.g. clicked.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the type that the signal operates on, e.g. GTK_TYPE_BUTTON.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD