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 ()

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

API 25 (Android(安卓)7.1.1 API) widget.Toast

【概述】

开发人员指南

【常量】

【构造函数】

【公共方法】

更多相关文章

随机推荐