org.gnu.glib
Class Idle

java.lang.Object
  extended by org.gnu.glib.Idle

Deprecated. This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may have an equivalent in java-gnome 4.0, see org.gnome.glib.Idle. You should be aware that there is a considerably different API in the new library: the architecture is completely different and most notably internals are no longer exposed to public view.

public final class Idle
extends java.lang.Object

Idle: an object that executes a Fireable target object's fire method at the next available time. Similar to Swing's invokeLater functionality.

For example, here's how an application clock might be implemented, where the application passes in an org.gnu.gtk.Label object as its pane:

 private Idle later = new Idle(100,
         new Fireable() {
             public boolean fire() {
                 String dateStr = DateFormat.getDateInstance()
                         .format(new Date());
                 System.out.println("Invoked later!" + dateStr);
                 return true; // continue firing
             }
         });
 later.start();
 

Note: an Idle generates events on the application's GUI event queue. It also should only be used to directly fire short/fast methods. Longer methods need to be executed in a separate thread.

See Also:
Fireable, Timer

Constructor Summary
Idle(Fireable target)
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Idle(int priority, Fireable target)
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 
Method Summary
protected  void finalize()
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 int getPriority()
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 boolean isRunning()
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 void setPriority(int priority)
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 void start()
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 void stop()
          Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Idle

public Idle(int priority,
            Fireable target)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Create a new Idle object.

Parameters:
priority - The execution priority of the object, from 0 (highest priority) to Integer.MAX_VALUE (lowest priority).
target - the object whose fire() method gets called after the specified time period elapses.
Throws:
java.lang.IllegalArgumentException - if less than zero.

Idle

public Idle(Fireable target)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Create a new Idle object.

Parameters:
target - the object whose fire() method gets called after the specified time period elapses.
Throws:
java.lang.IllegalArgumentException - if less than zero.
Method Detail

getPriority

public final int getPriority()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the execution priority for this Idle.

Returns:
the priority of this Idle, from 0 (highest priority) to Integer.MAX_VALUE (lowest priority)

setPriority

public final void setPriority(int priority)
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Set the execution priority for this Idle.

Parameters:
priority - The execution priority of the object, from 0 (highest priority) to Integer.MAX_VALUE (lowest priority).
Throws:
java.lang.IllegalArgumentException - if less than zero.

start

public final void start()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Start this Idle object; that is, begin executing its fire method at the available execution slot in the mainloop.


isRunning

public final boolean isRunning()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns whether this idle is running.

Returns:
true if this idle is currently running.

stop

public final void stop()
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Stop this idle object; that is, stop executing its fire method at its specified interval. This method does not need to be called if the fire method returned false.


finalize

protected final void finalize()
                       throws java.lang.Throwable
Deprecated. Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Do not call this method; it's only purpose is to ensure that the idle is stopped before it is GC'd.

Overrides:
finalize in class java.lang.Object
Throws:
java.lang.Throwable