Most visited

Recently visited

Added in API level 1

Toast

public class Toast
extends Object

java.lang.Object
   ↳ android.widget.Toast


吐司是一个包含用户快速消息的视图。 吐司类可以帮助您创建和显示这些。

向用户显示视图时,将显示为应用程序上的浮动视图。 它永远不会获得焦点。 用户可能正在输入其他内容。 这个想法应尽可能不显眼,同时向用户展示您希望他们看到的信息。 两个示例是音量控制,以及简短消息说您的设置已保存。

使用这个类的最简单的方法是调用一个静态方法来构造你需要的一切,并返回一个新的Toast对象。

Developer Guides

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

Summary

Constants

int LENGTH_LONG

长时间显示视图或文字通知。

int LENGTH_SHORT

短时间显示视图或文字通知。

Public constructors

Toast(Context context)

构建一个空的Toast对象。

Public methods

void cancel()

如果显示该视图,请关闭该视图;如果视图尚未显示,请关闭该视图。

int getDuration()

返回持续时间。

int getGravity()

获取通知应显示在屏幕上的位置。

float getHorizontalMargin()

返回水平边距。

float getVerticalMargin()

返回垂直边距。

View getView()

返回视图。

int getXOffset()

以像素为单位返回X偏移量以应用于重力的位置。

int getYOffset()

以像素为单位返回Y偏移量以应用于重力的位置。

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

使用资源中的文本制作只包含文本视图的标准吐司。

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

制作只包含文字视图的标准吐司。

void setDuration(int duration)

设置显示视图的时间。

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

设置通知应显示在屏幕上的位置。

void setMargin(float horizontalMargin, float verticalMargin)

设置视图的边距。

void setText(int resId)

更新先前使用其中一个makeText()方法创建的Toast中的文本。

void setText(CharSequence s)

更新先前使用其中一个makeText()方法创建的Toast中的文本。

void setView(View view)

设置要显示的视图。

void show()

显示指定持续时间的视图。

Inherited methods

From class java.lang.Object

Constants

LENGTH_LONG

Added in API level 1
int LENGTH_LONG

长时间显示视图或文字通知。 这一次可能是用户可定义的。

也可以看看:

常数值:1(0x00000001)

LENGTH_SHORT

Added in API level 1
int LENGTH_SHORT

短时间显示视图或文字通知。 这一次可能是用户可定义的。 这是默认设置。

也可以看看:

常量值:0(0x00000000)

Public constructors

Toast

Added in API level 1
Toast (Context context)

构建一个空的Toast对象。 您必须致电setView(View)然后才能致电show()

Parameters
context Context: The context to use. Usually your Application or Activity object.

Public methods

cancel

Added in API level 1
void cancel ()

如果显示该视图,请关闭该视图;如果视图尚未显示,请关闭该视图。 你通常不必调用它。 在适当的持续时间后,通常视图会自行消失。

getDuration

Added in API level 1
int getDuration ()

返回持续时间。

Returns
int

也可以看看:

getGravity

Added in API level 1
int getGravity ()

获取通知应显示在屏幕上的位置。

Returns
int

也可以看看:

getHorizontalMargin

Added in API level 1
float getHorizontalMargin ()

返回水平边距。

Returns
float

getVerticalMargin

Added in API level 1
float getVerticalMargin ()

返回垂直边距。

Returns
float

getView

Added in API level 1
View getView ()

返回视图。

Returns
View

也可以看看:

getXOffset

Added in API level 1
int getXOffset ()

以像素为单位返回X偏移量以应用于重力的位置。

Returns
int

getYOffset

Added in API level 1
int getYOffset ()

以像素为单位返回Y偏移量以应用于重力的位置。

Returns
int

makeText

Added in API level 1
Toast makeText (Context context, 
                int resId, 
                int duration)

使用资源中的文本制作只包含文本视图的标准吐司。

Parameters
context Context: The context to use. Usually your Application or Activity object.
resId int: The resource id of the string resource to use. Can be formatted text.
duration int: How long to display the message. Either LENGTH_SHORT or LENGTH_LONG
Returns
Toast
Throws
if the resource can't be found.
Resources.NotFoundException

makeText

Added in API level 1
Toast makeText (Context context, 
                CharSequence text, 
                int duration)

制作只包含文字视图的标准吐司。

Parameters
context Context: The context to use. Usually your Application or Activity object.
text CharSequence: The text to show. Can be formatted text.
duration int: How long to display the message. Either LENGTH_SHORT or LENGTH_LONG
Returns
Toast

setDuration

Added in API level 1
void setDuration (int duration)

设置显示视图的时间。

Parameters
duration int

也可以看看:

setGravity

Added in API level 1
void setGravity (int gravity, 
                int xOffset, 
                int yOffset)

设置通知应显示在屏幕上的位置。

Parameters
gravity int
xOffset int
yOffset int

也可以看看:

setMargin

Added in API level 1
void setMargin (float horizontalMargin, 
                float verticalMargin)

设置视图的边距。

Parameters
horizontalMargin float: The horizontal margin, in percentage of the container width, between the container's edges and the notification
verticalMargin float: The vertical margin, in percentage of the container height, between the container's edges and the notification

setText

Added in API level 1
void setText (int resId)

更新先前使用其中一个makeText()方法创建的Toast中的文本。

Parameters
resId int: The new text for the Toast.

setText

Added in API level 1
void setText (CharSequence s)

更新先前使用其中一个makeText()方法创建的Toast中的文本。

Parameters
s CharSequence: The new text for the Toast.

setView

Added in API level 1
void setView (View view)

设置要显示的视图。

Parameters
view View

也可以看看:

show

Added in API level 1
void show ()

显示指定持续时间的视图。

Hooray!