Android类参考---Toast

1.  继承关系

java.lang.Object

   |_____android.widget.Toast

2.  类概要

一个Toast就是一个包含提醒用户的快捷短消息的窗口。Toast类会帮助你创建和显示这个窗口。

当这个这个窗口显示给用户的时候，它会浮动显示在应用程序的上面。它不会接受焦点。用户在它显示期间也可以进行某些输入。这个想法是要尽可能不干扰用户的操作，同时依然能够显示希望用户要看到的信息。这个操作有两个例子：音量控制、保存成功的短消息提醒。

使用这个类的最容易的方法是调用其中的一个静态方法，它会返回一个新的Toast对象。

3.  类常量

public static final int LENGTH_LONG

用较长的时间来显示窗口或文本通知。这个时间是用户可定义的。

常量值：1（0x00000001）

public static final int LENGTH_SHORT

用较短的时间来显示窗口或文本通知。这个时间是用户可定义的。这个默认设置。

常量值：0（0x00000000）

4.  Public构造器

public Toast(Context context)

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

参数：

context：指定短消息要使用的上下文环境。通常是Application或Activity对象。

5.  Public方法

public void cancle()

如果Toast窗口正在显示，那么调用这个方法可以关闭这个窗口，如果这个窗口还没有显示，那么它就不会再显示了。通常不会调用这个方法，这个窗口在持续了相应的时间之后，会自己隐藏。

public int getDuration()

返回Toast窗口持续显示的时间。

public int getGravity()

获取Toast窗口在屏幕上应该显示的位置

public float getHorizontalMargin()

返回水平方向边距。

public float getVerticalMargin()

返回垂直方向的边距。

public View getView()

返回Toast窗口的View对象。

public int getXOffset()

以像素为单位，返回Toast窗口所使用的重力位置在X轴方向的偏移量。

public int getYOffset()

以像素为单位，返回Toast窗口所使用的重力位置在Y轴方向的偏移量。

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

用资源ID所指向文本制作一个只包含TextView对象的标准Toast窗口。

参数：

context：Toast窗口要使用的上下文环境，通常是Application或Activity对象。

resId：要使用的字符串资源ID，能够被格式化的文本。

duration：消息显示的时间。LENGTH_SHORT或LENGTH_LONG。

异常：如果没有找到资源，会抛出一个Resources.NotFoundException类型的异常。

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

制作一个只包含文本的标准Toast窗口。

参数：

context：Toast窗口要使用的上下文环境，通常是Application或Activity对象。

text：要显示的文本，能够被格式化。

Duration：消息显示的时间。LENGTH_SHORT或LENGTH_LONG

public void setDuration(int duration)

设置Toast窗口的显示时间。

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

设置Toast窗口在屏幕上的显示位置。

public void setMargin(float horizontalMargin, int verticalMargin)

设置Toast窗口的边距。

参数：

horizontalMargin：水平边距，用它的容器的宽度的百分比，定义容器的左右边界和通知窗口之间的距离。

verticalMargin：垂直边距，用它的容器的高度的百分比，定义容器上下边界和通知窗口之间的距离。

public void setText(int resId)

使用字符串资源来更新Toast窗口中的文本。

参数：

resId：Toast窗口要使用的新文本。

public void setText(CharSequence s)

使用参数中的文本更新Toast窗口中的文本。

参数：

s：Toast窗口要使用的新文本。

public void show()

显示Toast窗口。