>

>

>More on Signal Handlers

>

NAME="GENERATOR"

CONTENT="Modular DocBook HTML Stylesheet Version 1.79">

REL="HOME"

TITLE="GTK+ 2.0 Tutorial"

HREF="book1.html">

REL="UP"

TITLE="Moving On"

HREF="c325.html">

REL="PREVIOUS"

TITLE="Moving On"

HREF="c325.html">

REL="NEXT"

TITLE="An Upgraded Hello World"

HREF="x344.html">

>

CLASS="SECT1"

BGCOLOR="#FFFFFF"

TEXT="#000000"

LINK="#0000FF"

VLINK="#840084"

ALINK="#0000FF"

>

CLASS="NAVHEADER"

>

SUMMARY="Header navigation table"

WIDTH="100%"

BORDER="0"

CELLPADDING="0"

CELLSPACING="0"

>

>

COLSPAN="3"

ALIGN="center"

>GTK+ 2.0 Tutorial

>

>

>

WIDTH="10%"

ALIGN="left"

VALIGN="bottom"

>

HREF="c325.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="80%"

ALIGN="center"

VALIGN="bottom"

>Moving On

>

WIDTH="10%"

ALIGN="right"

VALIGN="bottom"

>

HREF="x344.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

ALIGN="LEFT"

WIDTH="100%">

>

CLASS="SECT1"

>

CLASS="SECT1"

>

NAME="SEC-MOREONSIGNALHANDLERS"

>More on Signal Handlers

>

>

>Lets take another look at the g_signal_connect() declaration.

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>gulong g_signal_connect( gpointer object,

                         const gchar *name,

                         GCallback func,

                         gpointer func_data );

>

>

>

>

>Notice the gulong return value? This is a tag that identifies your

callback function. As stated above, you may have as many callbacks per

signal and per object as you need, and each will be executed in turn,

in the order they were attached.

>

>This tag allows you to remove this callback from the list by using:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void g_signal_handler_disconnect( gpointer object,

                                  gulong   id );

>

>

>

>

>So, by passing in the widget you wish to remove the handler from, and

the tag returned by one of the signal_connect functions, you can

disconnect a signal handler.

>

>You can also temporarily disable signal handlers with the

g_signal_handler_block() and g_signal_handler_unblock() family of

functions.

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void g_signal_handler_block( gpointer object,

                             gulong   id );

void g_signal_handlers_block_by_func( gpointer  object,

                                      GCallback func,

                                      gpointer  data );

void g_signal_handler_unblock( gpointer object,

                               gulong   id );

void g_signal_handlers_unblock_by_func( gpointer  object,

                                        GCallback func,

                                        gpointer  data );

>

>

>

>

>

CLASS="NAVFOOTER"

>

ALIGN="LEFT"

WIDTH="100%">

SUMMARY="Footer navigation table"

WIDTH="100%"

BORDER="0"

CELLPADDING="0"

CELLSPACING="0"

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>

HREF="c325.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="book1.html"

ACCESSKEY="H"

>Home

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>

HREF="x344.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>Moving On

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="c325.html"

ACCESSKEY="U"

>Up

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>An Upgraded Hello World

>

>

>

>

>

>