Android - An Open Handset Alliance Project

android.os
public class

android.os.MessageQueue

java.lang.Object
	android.os.MessageQueue

Low-level class holding the list of messages to be dispatched by a Looper. Messages are not added directly to a MessageQueue, but rather through MessageQueue.IdleHandler objects associated with the Looper.

You can retrieve the MessageQueue for the current thread with Looper.myQueue().

Nested Classes

MessageQueue.IdleHandler Callback interface for discovering when a thread is going to block waiting for more messages.

Summary

Public Methods

final	void	addIdleHandler(IdleHandler handler)
		Add a new MessageQueue.IdleHandler to this message queue.
final	void	removeIdleHandler(IdleHandler handler)
		Remove an MessageQueue.IdleHandler from the queue that was previously added with addIdleHandler(MessageQueue.IdleHandler).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Public Methods

public final void addIdleHandler(IdleHandler handler)

Add a new MessageQueue.IdleHandler to this message queue. This may be removed automatically for you by returning false from IdleHandler.queueIdle() when it is invoked, or explicitly removing it with removeIdleHandler(MessageQueue.IdleHandler).

This method is safe to call from any thread.

Parameters

handler	The IdleHandler to be added.

public final void removeIdleHandler(IdleHandler handler)

Remove an MessageQueue.IdleHandler from the queue that was previously added with addIdleHandler(MessageQueue.IdleHandler). If the given object is not currently in the idle list, nothing is done.

Parameters

handler	The IdleHandler to be removed.

Android - An Open Handset Alliance Project

Documentation

Goodies

android.os.MessageQueue

Nested Classes

Summary

Public Methods

Methods inherited from class java.lang.Object

Details

Public Methods

public final void addIdleHandler(IdleHandler handler)

Parameters

public final void removeIdleHandler(IdleHandler handler)

Parameters


e.g. "intent" or "activity"