原链接:http://api.apkbus.com/reference/android/widget/Toast.html
类概述
Toast是为用户提供简短信息的视图.Toast类帮助你创建和显示该视图.
该视图以浮于应用程序之上的形式呈现给用户. 因为它并不获得焦点,即使用户正在输入也不会受到影响. 它的目标是尽可能不中断用户操作,并使用户看到你提供的信息. 有两个典型的例子就是音量控制和设置信息保存成功提示.
使用该类最简单的方法就是调用其静态方法,让他来构造你需要的一切并返回一个新的 Toast 对象.
摘要
常量 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | LENGTH_LONG | 持续显示视图或文本提示较长时间.该时间长度可定制. | |||||||||
int | LENGTH_SHORT | 持续显示视图或文本提示较短时间.该时间长度可定制.该值为默认值. |
公有构造函数 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
构造一个空的 Toast 对象.在调用 show() 之前,必须先调用 setView(View) . |
公有方法 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
如果视图已经显示则将其关闭,还没有显示则不再显示.一般不需要调用该方法. | |||||||||||
返回存续期间. | |||||||||||
取得提示信息在屏幕上显示位置. | |||||||||||
返回横向栏外空白. | |||||||||||
返回纵向栏外空白. | |||||||||||
返回视图对象. | |||||||||||
返回相对于指定显示位置的横向偏移像素量. | |||||||||||
返回相对于指定显示位置的纵向偏移像素量. | |||||||||||
生成一个从资源中取得的包含文本视图的标准 Toast 对象. | |||||||||||
生成一个包含文本的标准 Toast 视图对象. | |||||||||||
设置存续期间. | |||||||||||
设置提示信息在屏幕上的显示位置. | |||||||||||
设置视图的栏外空白. | |||||||||||
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容. | |||||||||||
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容. | |||||||||||
设置要显示的视图. | |||||||||||
按照指定的存续期间显示提示信息. |
[展开] 继承的方法 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
来自 class java.lang.Object |
常量
public static final int LENGTH_LONG
public static final int LENGTH_SHORT
公有构造函数
public Toast(Context context)
构造一个空的 Toast 对象.在调用 show()
之前,必须先调用 setView(View)
.
参数
context | 使用的上下文.通常是你的 Application 或 Activity 对象. |
---|
公有方法
public static ToastmakeText(Context context, int resId, int duration)
生成一个从资源中取得的包含文本视图的标准 Toast 对象.
参数
context | 使用的上下文.通常是你的 Application 或 Activity 对象. |
---|---|
resId | 要使用的字符串资源ID,可以是已格式化文本. |
duration | 该信息的存续期间.值为 LENGTH_SHORT 或 LENGTH_LONG . |
抛出
当资源未找到时 | |
Resources.NotFoundException |
public static ToastmakeText(Context context, CharSequence text, int duration)
生成一个包含文本的标准 Toast 视图对象.
参数
context | 使用的上下文.通常是你的 Application 或 Activity 对象. |
---|---|
text | 要显示的文本,可以是已格式化文本. |
duration | 该信息的存续期间.值为 LENGTH_SHORT 或 LENGTH_LONG . |
public void setMargin(float horizontalMargin, float verticalMargin)
设置视图的栏外空白.
参数
horizontalMargin | 容器的边缘与提示信息的横向空白(与容器宽度的比). |
---|---|
verticalMargin | 容器的边缘与提示信息的纵向空白(与容器高度的比). |
public void setText(int resId)
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.
参数
resId | 为 Toast 指定的新的字符串资源ID. |
---|
public void setText(CharSequence s)
更新之前通过 makeText() 方法生成的 Toast 对象的文本内容.
参数
s | 为 Toast 指定的新的文本. |
---|