Summary: Constants | Ctors | Methods | Inherited Methods | [Expand All]

public class

Toast

extends Object

java.lang.Object
↳	android.widget.Toast

Class Overview

A toast is a view containing a quick little message for the user. The toast class helps you create and show those.

When the view is shown to the user, appears as a floating view over the application. It will never receive focus. The user will probably be in the middle of typing something else. The idea is to be as unobtrusive as possible, while still showing the user the information you want them to see. Two examples are the volume control, and the brief message saying that your settings have been saved.

The easiest way to use this class is to call one of the static methods that constructs everything you need and returns a new Toast object.

Developer Guides

For information about creating Toast notifications, read the Toast Notifications developer guide.

Summary

Constants
int	LENGTH_LONG	Show the view or text notification for a long period of time.
int	LENGTH_SHORT	Show the view or text notification for a short period of time.

Public Constructors
	Toast(Context context) Construct an empty Toast object.

Public Methods
void	cancel() Close the view if it's showing, or don't show it if it isn't showing yet.
int	getDuration() Return the duration.
int	getGravity() Get the location at which the notification should appear on the screen.
float	getHorizontalMargin() Return the horizontal margin.
float	getVerticalMargin() Return the vertical margin.
View	getView() Return the view.
int	getXOffset() Return the X offset in pixels to apply to the gravity's location.
int	getYOffset() Return the Y offset in pixels to apply to the gravity's location.
static Toast	makeText(Context context, int resId, int duration) Make a standard toast that just contains a text view with the text from a resource.
static Toast	makeText(Context context, CharSequence text, int duration) Make a standard toast that just contains a text view.
void	setDuration(int duration) Set how long to show the view for.
void	setGravity(int gravity, int xOffset, int yOffset) Set the location at which the notification should appear on the screen.
void	setMargin(float horizontalMargin, float verticalMargin) Set the margins of the view.
void	setText(int resId) Update the text in a Toast that was previously created using one of the makeText() methods.
void	setText(CharSequence s) Update the text in a Toast that was previously created using one of the makeText() methods.
void	setView(View view) Set the view to show.
void	show() Show the view for the specified duration.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Constants

public static final int LENGTH_LONG

Since: API Level 1

Show the view or text notification for a long period of time. This time could be user-definable.

public static final int LENGTH_SHORT

Since: API Level 1

Show the view or text notification for a short period of time. This time could be user-definable. This is the default.

context	The context to use. Usually your `Application` or `Activity` object.
resId	The resource id of the string resource to use. Can be formatted text.
duration	How long to display the message. Either `LENGTH_SHORT` or `LENGTH_LONG`

context	The context to use. Usually your `Application` or `Activity` object.
text	The text to show. Can be formatted text.
duration	How long to display the message. Either `LENGTH_SHORT` or `LENGTH_LONG`

horizontalMargin	The horizontal margin, in percentage of the container width, between the container's edges and the notification
verticalMargin	The vertical margin, in percentage of the container height, between the container's edges and the notification

	if the resource can't be found.
Resources.NotFoundException

Interfaces

Classes

Enums

Exceptions

Toast

Class Overview

Developer Guides

Summary

Constants

public static final int LENGTH_LONG

See Also

public static final int LENGTH_SHORT

See Also

Public Constructors

public Toast (Context context)

Parameters

Public Methods

public void cancel ()

public int getDuration ()

See Also

public int getGravity ()

See Also

public float getHorizontalMargin ()

public float getVerticalMargin ()

public View getView ()

See Also

public int getXOffset ()

public int getYOffset ()

public static Toast makeText (Context context, int resId, int duration)

Parameters

Throws

public static Toast makeText (Context context, CharSequence text, int duration)

Parameters

public void setDuration (int duration)

See Also

public void setGravity (int gravity, int xOffset, int yOffset)

See Also

public void setMargin (float horizontalMargin, float verticalMargin)

Parameters

public void setText (int resId)

Parameters

public void setText (CharSequence s)

Parameters

public void setView (View view)

See Also

public void show ()