<div class="SECT2">        <h2 class="SECT2">          <a name="Z62">Timeout Functions</a>        </h2>        <p>          <i class="FIRSTTERM">Timeout functions</i> are connected          and disconnected exactly as quit functions are; the          expected callback is the same. <tt class="FUNCTION">          gtk_timeout_add()</tt> expects an <span class=          "STRUCTNAME">interval</span> argument; the callback is          invoked every <span class="STRUCTNAME">interval</span>          milliseconds. If the callback ever returns <span class=           "STRUCTNAME">FALSE</span>, it is removed from the list of          timeout functions, just as if you'd called <tt class=           "FUNCTION">gtk_timeout_remove()</tt>. It is not safe to          call <tt class="FUNCTION">gtk_timeout_remove()</tt> from          within a timeout function; this modifies the timeout list          while GTK+ is iterating over it, causing a crash.          Instead, return <span class="STRUCTNAME">FALSE</span> to          remove a function.        </p>        <div class="FIGURE">          <a name="FL-TIMEOUTFUNCS"></a>          <div class="FUNCSYNOPSIS">            <a name="FL-TIMEOUTFUNCS.SYNOPSIS"></a>            <table border="0" bgcolor="#E0E0E0" width="100%">              <tr>                <td><pre class="FUNCSYNOPSISINFO">#include &lt;gtk/gtkmain.h&gt;</pre>                </td>              </tr>            </table>            <p>              <code><code class="FUNCDEF">guint <tt class=              "FUNCTION">gtk_timeout_add</tt></code>(guint32 <tt              class="PARAMETER"><i>interval</i></tt>, GtkFunction              <tt class="PARAMETER"><i>function</i></tt>, gpointer              <tt class="PARAMETER"><i>data</i></tt>);</code>            </p>            <p>              <code><code class="FUNCDEF">void <tt class=              "FUNCTION">gtk_timeout_remove</tt></code>(guint <tt              class="PARAMETER"><i>              timeout_handler_id</i></tt>);</code>            </p>          </div>          <p>            <b>Figure 30. Timeout Functions</b>          </p>        </div>      </div>      <div class="SECT2">        <h2 class="SECT2">          <a name="Z63">Idle Functions</a>        </h2>        <p>          <i class="FIRSTTERM">Idle functions</i> run continuously          while the GTK+ main loop has nothing else to do. Idle          functions run only when the event queue is empty and the          main loop would normally sit idly, waiting for something          to happen. As long as they return <span class=          "STRUCTNAME">TRUE</span> they are invoked over and over;          when they return <span class="STRUCTNAME">FALSE</span>,          they are removed, just as if <tt class="FUNCTION">          gtk_idle_remove()</tt> had been called.        </p>        <p>          The idle function API, shown in <a href=           "sec-mainloop.html#FL-IDLEFUNCS">Figure 31</a>, is          identical to the timeout and quit function APIs. Again,          <tt class="FUNCTION">gtk_idle_remove()</tt> should not be          called from within an idle function, because it will          corrupt GTK+'s idle function list. Return <span class=           "STRUCTNAME">FALSE</span> to remove the idle function.        </p>        <p>          Idle functions are mostly useful to queue "one-shot"          code, which is run after all events have been handled.          Relatively expensive operations such as GTK+ size          negotiation and <tt class="CLASSNAME">GnomeCanvas</tt>          repaints take place in idle functions that return <span          class="STRUCTNAME">FALSE</span>. This ensures that          expensive operations are performed only once, even though          multiple consecutive events independently request the          recalculation.        </p>        <p>          The GTK+ main loop contains a simple scheduler; idle          functions actually have priorities assigned to them, just          as UNIX processes do. You can assign a non-default          priority to your idle functions, but it's a complicated          topic outside the scope of this book.        </p>        <div class="FIGURE">          <a name="FL-IDLEFUNCS"></a>          <div class="FUNCSYNOPSIS">            <a name="FL-IDLEFUNCS.SYNOPSIS"></a>            <table border="0" bgcolor="#E0E0E0" width="100%">              <tr>                <td><pre class="FUNCSYNOPSISINFO">#include &lt;gtk/gtkmain.h&gt;</pre>                </td>              </tr>            </table>            <p>              <code><code class="FUNCDEF">guint <tt class=              "FUNCTION">gtk_idle_add</tt></code>(GtkFunction <tt              class="PARAMETER"><i>function</i></tt>, gpointer <tt              class="PARAMETER"><i>data</i></tt>);</code>            </p>            <p>              <code><code class="FUNCDEF">void <tt class=              "FUNCTION">gtk_idle_remove</tt></code>(guint <tt              class="PARAMETER"><i>              idle_handler_id</i></tt>);</code>            </p>            <p>              <code><code class="FUNCDEF">void <tt class=              "FUNCTION">              gtk_idle_remove_by_data</tt></code>(gpointer <tt              class="PARAMETER"><i>data</i></tt>);</code>            </p>          </div>          <p>            <b>Figure 31. Idle Functions</b>          </p>        </div>      </div>      <div class="SECT2">        <h2 class="SECT2">          <a name="Z64">Input Functions</a>        </h2>        <p>          <i class="FIRSTTERM">Input functions</i> are handled on          the GDK level. They are invoked when a given file          descriptor is ready for reading or writing. They're          especially useful for networked applications.        </p>        <p>          To add an input function, you specify the file descriptor          to monitor, the state you want to wait for (ready for          reading or writing), and a callback/data pair. <a href=           "sec-mainloop.html#FL-INPUTFUNCS">Figure 32</a> shows the          API. Functions can be removed using the tag returned by          <tt class="FUNCTION">gdk_input_add()</tt>. Unlike quit,          timeout, and idle functions, it should be safe to call          <tt class="FUNCTION">gdk_input_remove()</tt> from inside          the input function; GTK+ will not be in the midst of          iterating over the list of input functions.        </p>        <p>          To specify the condition(s) to wait for, use the <span          class="STRUCTNAME">GdkInputCondition</span> flags: <span          class="STRUCTNAME">GDK_INPUT_READ</span>, <span class=           "STRUCTNAME">GDK_INPUT_WRITE</span>, and <span class=           "STRUCTNAME">GDK_INPUT_EXCEPTION</span>. You can OR one          or more flags together. These correspond to the three          file descriptor sets passed to the <tt class="FUNCTION">          select()</tt> system call; consult a good UNIX          programming book for details. If any condition is met,          the input function is invoked.        </p>        <p>          The callback should look like this:        </p>        <table border="0" bgcolor="#E0E0E0" width="100%">          <tr>            <td><pre class="PROGRAMLISTING">&#13;typedef void (*GdkInputFunction) (gpointer data,                                  gint source_fd,                                  GdkInputCondition condition);&#13;</pre>            </td>          </tr>        </table>        <p>          It receives your callback data, the file descriptor being          watched, and the conditions that were met (possibly a          subset of those you were watching for).        </p>        <div class="FIGURE">          <a name="FL-INPUTFUNCS"></a>          <div class="FUNCSYNOPSIS">            <a name="FL-INPUTFUNCS.SYNOPSIS"></a>            <table border="0" bgcolor="#E0E0E0" width="100%">              <tr>                <td><pre class="FUNCSYNOPSISINFO">#include &lt;gdk/gdk.h&gt;</pre>                </td>              </tr>            </table>            <p>              <code><code class="FUNCDEF">gint <tt class=              "FUNCTION">gdk_input_add</tt></code>(gint <tt class=               "PARAMETER"><i>source_fd</i></tt>, GdkInputCondition              <tt class="PARAMETER"><i>condition</i></tt>,              GdkInputFunction <tt class="PARAMETER"><i>              function</i></tt>, gpointer <tt class="PARAMETER"><i>              data</i></tt>);</code>            </p>            <p>              <code><code class="FUNCDEF">void <tt class=              "FUNCTION">gdk_input_remove</tt></code>(gint <tt              class="PARAMETER"><i>tag</i></tt>);</code>            </p>          </div>          <p>            <b>Figure 32. Input Functions</b>          </p>        </div>      </div>    </div>    <div class="NAVFOOTER">      <br>      <br>      <table width="100%" border="0" bgcolor="#ffffff" cellpadding=       "1" cellspacing="0">        <tr>          <td width="25%" bgcolor="#ffffff" align="left">            <a href="z57.html"><font color="#0000ff" size="2"><b>            &lt;&lt;&lt; Previous</b></font></a>          </td>          <td width="25%" colspan="2" bgcolor="#ffffff" align=           "center">            <font color="#0000ff" size="2"><b><a href="ggad.html">            <font color="#0000ff" size="2"><b>            Home</b></font></a></b></font>          </td>          <td width="25%" bgcolor="#ffffff" align="right">            <a href="build-app.html"><font color="#0000ff" size=            "2"><b>Next &gt;&gt;&gt;</b></font></a>          </td>        </tr>        <tr>          <td colspan="2" align="left">            <font color="#000000" size="2"><b>Widget            Concepts</b></font>          </td>          <td colspan="2" align="right">            <font color="#000000" size="2"><b>Building a Gnome            Application</b></font>          </td>        </tr>      </table>    </div>  </body></html>