File	Doc	Category	Size	Date	Package
Toast.java	API Doc	Android 1.5 API	13205	Wed May 06 22:41:56 BST 2009	android.widget

Toast

• java.lang.Object

Fields Summary
static final String	TAG
static final boolean	localLOGV
public static final int	LENGTH_SHORT Show the view or text notification for a short period of time. This time could be user-definable. This is the default.
public static final int	LENGTH_LONG Show the view or text notification for a long period of time. This time could be user-definable.
final android.content.Context	mContext
final TN	mTN
int	mDuration
int	mGravity
int	mX
int	mY
float	mHorizontalMargin
float	mVerticalMargin
android.view.View	mView
android.view.View	mNextView
private static android.app.INotificationManager	sService
final android.os.Handler	mHandler

Constructors Summary

public Toast(android.content.Context context) Construct an empty Toast object. You must call {@link #setView} before you can call {@link #show}. param context The context to use. Usually your {@link android.app.Application} or {@link android.app.Activity} object. mContext = context; mTN = new TN(context); mY = context.getResources().getDimensionPixelSize( com.android.internal.R.dimen.toast_y_offset);

Methods Summary
public void	cancel() Close the view if it's showing, or don't show it if it isn't showing yet. You do not normally have to call this. Normally view will disappear on its own after the appropriate duration. mTN.hide(); // TODO this still needs to cancel the inflight notification if any
public int	getDuration() Return the duration. see #setDuration return mDuration;
public int	getGravity() Get the location at which the notification should appear on the screen. see android.view.Gravity see #getGravity return mGravity;
public float	getHorizontalMargin() Return the horizontal margin. return mHorizontalMargin;
private static android.app.INotificationManager	getService() if (sService != null) { return sService; } sService = INotificationManager.Stub.asInterface(ServiceManager.getService("notification")); return sService;
public float	getVerticalMargin() Return the vertical margin. return mVerticalMargin;
public android.view.View	getView() Return the view. see #setView return mNextView;
public int	getXOffset() Return the X offset in pixels to apply to the gravity's location. return mX;
public int	getYOffset() Return the Y offset in pixels to apply to the gravity's location. return mY;
public static android.widget.Toast	makeText(android.content.Context context, java.lang.CharSequence text, int duration) Make a standard toast that just contains a text view. param context The context to use. Usually your {@link android.app.Application} or {@link android.app.Activity} object. param text The text to show. Can be formatted text. param duration How long to display the message. Either {@link #LENGTH_SHORT} or {@link #LENGTH_LONG} Toast result = new Toast(context); LayoutInflater inflate = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); View v = inflate.inflate(com.android.internal.R.layout.transient_notification, null); TextView tv = (TextView)v.findViewById(com.android.internal.R.id.message); tv.setText(text); result.mNextView = v; result.mDuration = duration; return result;
public static android.widget.Toast	makeText(android.content.Context context, int resId, int duration) Make a standard toast that just contains a text view with the text from a resource. param context The context to use. Usually your {@link android.app.Application} or {@link android.app.Activity} object. param resId The resource id of the string resource to use. Can be formatted text. param duration How long to display the message. Either {@link #LENGTH_SHORT} or {@link #LENGTH_LONG} throws Resources.NotFoundException if the resource can't be found. return makeText(context, context.getResources().getText(resId), duration);
public void	setDuration(int duration) Set how long to show the view for. see #LENGTH_SHORT see #LENGTH_LONG mDuration = duration;
public void	setGravity(int gravity, int xOffset, int yOffset) Set the location at which the notification should appear on the screen. see android.view.Gravity see #getGravity mGravity = gravity; mX = xOffset; mY = yOffset;
public void	setMargin(float horizontalMargin, float verticalMargin) Set the margins of the view. param horizontalMargin The horizontal margin, in percentage of the container width, between the container's edges and the notification param verticalMargin The vertical margin, in percentage of the container height, between the container's edges and the notification mHorizontalMargin = horizontalMargin; mVerticalMargin = verticalMargin;
public void	setText(int resId) Update the text in a Toast that was previously created using one of the makeText() methods. param resId The new text for the Toast. setText(mContext.getText(resId));
public void	setText(java.lang.CharSequence s) Update the text in a Toast that was previously created using one of the makeText() methods. param s The new text for the Toast. if (mNextView == null) { throw new RuntimeException("This Toast was not created with Toast.makeText()"); } TextView tv = (TextView) mNextView.findViewById(com.android.internal.R.id.message); if (tv == null) { throw new RuntimeException("This Toast was not created with Toast.makeText()"); } tv.setText(s);
public void	setView(android.view.View view) Set the view to show. see #getView mNextView = view;
public void	show() Show the view for the specified duration. if (mNextView == null) { throw new RuntimeException("setView must have been called"); } INotificationManager service = getService(); String pkg = mContext.getPackageName(); TN tn = mTN; try { service.enqueueToast(pkg, tn, mDuration); } catch (RemoteException e) { // Empty }