API 25 (Android 7.1.1 API) widget.Toast


Android API 25 (Android 7.1.1 API)

Toast
public class Toast
extends Object
Added in
API level 1
 
java.lang.Object
   ↳android.widget.Toast
 

【概述】

Toast是一种提供给用户简洁信息的视图。Toast类帮助你创建和显示该信息。
该视图以浮于应用程序之上的形式呈现给用户。因为它并不获得焦点，即使用户正在输入什么也不会受到影响。它的目标是尽可能已不显眼的方式，使用户看到你提供的信息。
使用该类最简单的方法就是调用一个静态方法，让他来构造你需要的一切并返回一个新的 Toast对象。
 

开发人员指南

有关创建Toast通知的信息，请阅读开发人员指南Toasts。
 

【常量】

int  LENGTH_LONG =
1
持续显示视图或文本提示较长时间。该时间长度可定制。
Int  LENGTH_SHORT =
0
持续显示视图或文本提示较短时间。该时间长度可定制。
 

【构造函数】

public Toast (Context context)
构造一个空的 Toast对象。在调用show()之前，必须先调用setView(View)。
（只有使用setView(View)的时候，才使用new Toast(Content content)来得到Toast对象，否则必须用makeText()方法来创建toast对象，并且这种方式获得Toast对象不能使用setText()方法。）
参数context使用的上下文。通常是你的Application或Activity对象。
 

【公共方法】

 
cancel
void cancel ()
如果视图已经显示则将其关闭，还没有显示则不再显示。一般不需要调用该方法。正常情况下，视图会在超过存续期间后消失。
 
setDuration
void setDuration (int duration)
设置存续期间。
getDuration
int getDuration ()
返回存续期间。
 
 
setGravity
void setGravity (int gravity, int xOffset, int yOffset)
设置提示信息在屏幕上的显示位置。
（自定义Toast的显示位置，例如toast.setGravity(Gravity.CENTER_VERTICAL, 0,
0)可以把Toast定位在左上角。Toast提示的位置xOffset:大于0向右移，小于0向左移）
getGravity
int getGravity ()
取得提示信息在屏幕上显示的位置。
 
 
getHorizontalMargin
float getHorizontalMargin ()
返回水平边距。
getVerticalMargin
float getVerticalMargin ()
返回垂直边距。
 
setView
void setView (View view)
设置视图View。
getView
View getView ()
返回视图View。
 
getXOffset
int getXOffset ()
返回相对于参照位置的横向偏移像素量。
getYOffset
int getYOffset ()
返回相对于参照位置的纵向偏移像素量。
 
        Toast msg = Toast.makeText(Main.this, "Message", Toast.LENGTH_LONG);
        msg.setGravity(Gravity.CENTER, msg.getXOffset() / 2, msg.getYOffset() / 2);
        msg.show();
 
 
makeText
Toast makeText (Context context, int resId, int duration)
生成一个从资源中取得的包含文本视图的标准 Toast对象。
Context 使用的上下文。通常是你的
Application或 Activity对象。
resId   要使用的字符串资源ID，可以是已格式化文本。
Duration该信息的存续期间。值为
LENGTH_SHORT或LENGTH_LONG
异常：当资源未找到时抛异常Resources.NotFoundException
Toast makeText (Context context, CharSequence text, int duration)
生成一个包含文本视图的标准 Toast对象。
Context 使用的上下文。通常是你的
Application或 Activity对象。
text    要显示的文本，可以是已格式化文本。
Duration该信息的存续期间。值为
LENGTH_SHORT或LENGTH_LONG
 
setMargin
void setMargin (float horizontalMargin, float verticalMargin)
设置视图的边距。
 
setText
void setText (int resId)
void setText (CharSequence s)
更新之前通过 makeText()方法生成的Toast对象的文本内容。
 
 
show
void show ()
按照指定的存续期间显示提示信息。