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視窗。