原链接：http://api.apkbus.com/reference/android/widget/Toast.html

类概述

Toast是为用户提供简短信息的视图.Toast类帮助你创建和显示该视图.


该视图以浮于应用程序之上的形式呈现给用户. 因为它并不获得焦点，即使用户正在输入也不会受到影响. 它的目标是尽可能不中断用户操作，并使用户看到你提供的信息. 有两个典型的例子就是音量控制和设置信息保存成功提示.

使用该类最简单的方法就是调用其静态方法，让他来构造你需要的一切并返回一个新的 Toast 对象.

摘要

常量
intLENGTH_LONG持续显示视图或文本提示较长时间.该时间长度可定制.








intLENGTH_SHORT持续显示视图或文本提示较短时间.该时间长度可定制.该值为默认值.








公有构造函数

Toast(Context context)
构造一个空的 Toast 对象.在调用 show() 之前，必须先调用 setView(View).










公有方法
voidcancel()
如果视图已经显示则将其关闭，还没有显示则不再显示.一般不需要调用该方法.










intgetDuration()
返回存续期间.










intgetGravity()
取得提示信息在屏幕上显示位置.










floatgetHorizontalMargin()
返回横向栏外空白.










floatgetVerticalMargin()
返回纵向栏外空白.










ViewgetView()
返回视图对象.










intgetXOffset()
返回相对于指定显示位置的横向偏移像素量.










intgetYOffset()
返回相对于指定显示位置的纵向偏移像素量.










static ToastmakeText(Context context, int resId, int duration)
生成一个从资源中取得的包含文本视图的标准 Toast 对象.










static ToastmakeText(Context context, CharSequence text, int duration)
生成一个包含文本的标准 Toast 视图对象.










voidsetDuration(int duration)
设置存续期间.










voidsetGravity(int gravity, int xOffset, int yOffset)
设置提示信息在屏幕上的显示位置.










voidsetMargin(float horizontalMargin, float verticalMargin)
设置视图的栏外空白.










voidsetText(int resId)
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.










voidsetText(CharSequence s)
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.










voidsetView(View view)
设置要显示的视图.










voidshow()
按照指定的存续期间显示提示信息.










[展开]
继承的方法











triangle-closed.png 来自 class java.lang.Object

常量

public static final int LENGTH_LONG
引入自： API 级别1

持续显示视图或文本提示较长时间.该时间长度可定制.

参见
常量值： 1 (0x00000001)
public static final int LENGTH_SHORT
引入自： API 级别1

持续显示视图或文本提示较短时间.该时间长度可定制.该值为默认值.

参见
常量值： 0 (0x00000000)

公有构造函数

public Toast(Context context)
引入自： API 级别1

构造一个空的 Toast 对象.在调用 show() 之前，必须先调用 setView(View).

参数
context使用的上下文.通常是你的 Application 或 Activity 对象.

公有方法

public void cancel()
引入自： API 级别1

如果视图已经显示则将其关闭，还没有显示则不再显示.一般不需要调用该方法. 正常情况下，视图会在超过存续期间后消失.

public int getDuration()
引入自： API 级别1

返回存续期间.

参见
public int getGravity()
引入自： API 级别1

取得提示信息在屏幕上显示位置.

参见
public float getHorizontalMargin()
引入自： API 级别1

返回横向栏外空白.

public float getVerticalMargin()
引入自： API 级别1

返回纵向栏外空白.

public ViewgetView()
引入自： API 级别1

返回视图对象.

参见
public int getXOffset()
引入自： API 级别1

返回相对于指定显示位置的横向偏移像素量.

public int getYOffset()
引入自： API 级别1

返回相对于指定显示位置的纵向偏移像素量.

public static ToastmakeText(Context context, int resId, int duration)
引入自： API 级别1

生成一个从资源中取得的包含文本视图的标准 Toast 对象.

参数
context使用的上下文.通常是你的 Application 或 Activity 对象.
resId要使用的字符串资源ID，可以是已格式化文本.
duration该信息的存续期间.值为 LENGTH_SHORT 或 LENGTH_LONG.
抛出

当资源未找到时
Resources.NotFoundException
public static ToastmakeText(Context context, CharSequence text, int duration)
引入自： API 级别1

生成一个包含文本的标准 Toast 视图对象.

参数
context使用的上下文.通常是你的 Application 或 Activity 对象.
text要显示的文本，可以是已格式化文本.
duration该信息的存续期间.值为 LENGTH_SHORT 或 LENGTH_LONG.
public void setDuration(int duration)
引入自： API 级别1

设置存续期间.

参见
public void setGravity(int gravity, int xOffset, int yOffset)
引入自： API 级别1

设置提示信息在屏幕上的显示位置.

参见
public void setMargin(float horizontalMargin, float verticalMargin)
引入自： API 级别1

设置视图的栏外空白.

参数
horizontalMargin容器的边缘与提示信息的横向空白（与容器宽度的比）.
verticalMargin容器的边缘与提示信息的纵向空白（与容器高度的比）.
public void setText(int resId)
引入自： API 级别1

更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.

参数
resId为 Toast 指定的新的字符串资源ID.
public void setText(CharSequence s)
引入自： API 级别1

更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.

参数
s为 Toast 指定的新的文本.
public void setView(View view)
引入自： API 级别1

设置要显示的视图.

参见
public void show()
引入自： API 级别1

按照指定的存续期间显示提示信息.