public class Toast
extends Object
java.lang.Object | |
↳ | android.widget.Toast |
吐司是一个包含用户快速消息的视图。 吐司类可以帮助您创建和显示这些。
向用户显示视图时,将显示为应用程序上的浮动视图。 它永远不会获得焦点。 用户可能正在输入其他内容。 这个想法应尽可能不显眼,同时向用户展示您希望他们看到的信息。 两个示例是音量控制,以及简短消息说您的设置已保存。
使用这个类的最简单的方法是调用一个静态方法来构造你需要的一切,并返回一个新的Toast对象。
有关创建Toast通知的信息,请阅读 Toast Notifications开发人员指南。
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
|
int LENGTH_LONG
长时间显示视图或文字通知。 这一次可能是用户可定义的。
也可以看看:
常数值:1(0x00000001)
int LENGTH_SHORT
短时间显示视图或文字通知。 这一次可能是用户可定义的。 这是默认设置。
也可以看看:
常量值:0(0x00000000)
Toast (Context context)
构建一个空的Toast对象。 您必须致电setView(View)
然后才能致电show()
。
Parameters | |
---|---|
context |
Context : The context to use. Usually your Application or Activity object. |
void cancel ()
如果显示该视图,请关闭该视图;如果视图尚未显示,请关闭该视图。 你通常不必调用它。 在适当的持续时间后,通常视图会自行消失。
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 |
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 |
void setDuration (int duration)
设置显示视图的时间。
Parameters | |
---|---|
duration |
int
|
也可以看看:
void setGravity (int gravity, int xOffset, int yOffset)
设置通知应显示在屏幕上的位置。
Parameters | |
---|---|
gravity |
int
|
xOffset |
int
|
yOffset |
int
|
也可以看看:
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 |
void setText (int resId)
更新先前使用其中一个makeText()方法创建的Toast中的文本。
Parameters | |
---|---|
resId |
int : The new text for the Toast. |
void setText (CharSequence s)
更新先前使用其中一个makeText()方法创建的Toast中的文本。
Parameters | |
---|---|
s |
CharSequence : The new text for the Toast. |