GtkSharp/doc/en/GLib/Idle.xml

<Type Name="Idle" FullName="GLib.Idle">
  <TypeSignature Language="C#" Value="public class Idle" Maintainer="auto" />
  <AssemblyInfo>
    <AssemblyName>glib-sharp</AssemblyName>
    <AssemblyVersion>0.0.0.0</AssemblyVersion>
    <Attributes />
  </AssemblyInfo>
  <ThreadSafetyStatement>This function is thread safe.</ThreadSafetyStatement>
  <Docs>
    <summary>Idle handlers for GLib-based main-loops</summary>
    <remarks>
      GLib provides an implementation of a "main loop" (an event-based
      main loop that dispatches requests).  The Idle handler class is
      used to register a routine to be called when the main loop is
      idle. 
    </remarks>
  </Docs>
  <Base>
    <BaseTypeName>System.Object</BaseTypeName>
  </Base>
  <Interfaces />
  <Attributes />
  <Members>
    <Member MemberName="Add">
      <MemberSignature Language="C#" Value="public static uint Add (GLib.IdleHandler hndlr);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.UInt32</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="hndlr" Type="GLib.IdleHandler" />
      </Parameters>
      <Docs>
        <summary>Installs an idle handler for the main loop.</summary>
        <param name="hndlr">The delegate method that will be invoked.</param>
        <returns>The handler code assigned to this idle handler.</returns>
        <remarks>
          <para>
	    This function installs the <paramref name="hndlr" /> as a
	    handler to be invoked when the GLib mainloop is idle.  If
	    the handler returns <see langword="true" /> the handler is
	    kept for another round of Idle execution, if <see langword="false" /> is returned, the handler is removed. 
	  </para>
          <para>
	    This method can be invoked from a differen thread than the
	    one running the Gtk main loop.  The delegate will be
	    invoked within the context of the Gtk main loop.
	  </para>
          <para>
	    The thread-safety of this routine can be used to queue
	    work by a thread to be performed in the context of the
	    main Gtk thread.  Gtk# is thread aware, but not thread
	    safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread
	    Programming</link> for details.
	  </para>
        </remarks>
      </Docs>
    </Member>
  </Members>
</Type>