RemoteViews

版本：Android 4.0 r1

?

結(jié)構(gòu)

繼承關系

public class RemoteViews extends Object implements Parcelable,LayoutInflater.Filter

????????

java.lang.Object

android.widget.RemoteViews

?

類概述

一個描述了可以在其他進程中顯示的view層，它inflate于layout資源文件，并且這個類對提供一些基本操作修改view內(nèi)容。

????????

字段

public static final Creator<RemoteViews>

構(gòu)造器Parcelable.Creator用來實例化RemoteViews類

?

內(nèi)部類

class? RemoteViews.ActionException

錯誤發(fā)生并發(fā)送異常時執(zhí)行的動作

?

@interface? RemoteViews.RemoteView

這個標記指明View的子類可以使用RemoteViews機制

?

構(gòu)造函數(shù)

?????? public RemoteViews(String packageName, int layoutId)

???????? 通過指定的布局文件新建一個RemoteViews對象。

????????

public RemoteViews(Parcel parcel)

從一個parcel中讀取RemoteViews對象。

?

公共方法

public void addView (int viewId, RemoteViews nestedView)

???????? 相當于當inflate指定的RemoteViews后調(diào)用addView(View)。它允許用戶構(gòu)建”nested(內(nèi)部)”RemoteViews。在某種情況下RemoteViews可以回收布局，使用removeAllViews(int)清除所有存在的子視圖。

參數(shù)

??????????????????????????? viewId????? 要加入子視圖的父ViewGroup的id

??????????????????????????? nestedView???? 描述子視圖的RemoteViews

?

public void apply(Context context, ViewGroup parent)

???????? Inflates視圖對象并且應用到所有的動作中。

???????? 調(diào)用注意：這個方法可能有異常拋出。

參數(shù)

??????????????????????????? Context??? 默認使用的context

??????????????????????????? parent????? 生成視圖層將要填充的parent。此方法不會附加到層次結(jié)構(gòu)。調(diào)用者應該在適當?shù)臅r候處理。

?????????????????? 返回值

??????????????????????????? 被inflated的視圖層

?

public RemoteViews clone ()

???????? 創(chuàng)建并返回這個對象的復本。默認的實現(xiàn)返回一個淺拷貝：它重新創(chuàng)建這個類的實例并從原來的實例中復制字段值（包括類相關的）到這個新的實例。相比之下，深拷貝，還會遞歸復制嵌套類

?????????????????? 返回值

??????????????????????????? 對象的復本。

?

public int describeContents ()

???????? 描述對象在Parcelable中特定的編碼形式

?????????????????? 返回值

??????????????????????????? 返回由Parcelable特定編碼形式的對象類型的位掩碼

??????????????????

public int getLayoutId ()

（譯者注：返回Inflates視圖的id）

?

public String getPackage ()

?

?

public boolean onLoadClass (Class clazz)

???????? Hook允許LayoutInflater客戶端限制設置視圖，即允許被inflated。

參數(shù)

??????????????????????????? clazz???????? ???????? 用來inflated的視圖對象

?????????????????? 返回值

??????????????????????????? 如果允許這個類inflated，返回true，否則返回false

?

public void reapply (Context context, View v)

???????? 為視圖對象應用所有的動作

參數(shù)

??????????????????????????? v?????? ???????? 要應用動作的視圖。這個應該是apply(Context, ViewGroup)調(diào)用的結(jié)果

?

public void removeAllViews (int viewId)

???????? 相當于調(diào)用removeAllViews().

參數(shù)

??????????????????????????? viewed???? 要移除所有子視圖的父ViewGroup的id

?

public void setBitmap (int viewId, String methodName, Bitmap value)

為RemoteViews在視圖布局上調(diào)用一個帶有Bitmap值的方法。

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

????????

public void setBoolean (int viewId, String methodName, boolean value)

為RemoteViews在視圖布局上調(diào)用一個帶有boolean值的方法。

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

????????

public void setBundle (int viewId, String methodName, Bundle value)

為RemoteViews在視圖而已上調(diào)用一個帶有Bundle值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

????????

public void setByte (int viewId, String methodName, byte value)

為RemoteViews在視圖而已上調(diào)用一個帶有byte值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setChar (int viewId, String methodName, char value)

為RemoteViews在視圖而已上 調(diào)用一個帶有char值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setCharSequence (int viewId, String methodName, CharSequence value)

為RemoteViews在視圖而已上調(diào)用一個帶有CharSequence值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setChronometer (int viewId, long base, String format, boolean started)???

等同于調(diào)用Chronometer.setBase, Chronometer.setFormat,和Chronometer.start() 或者 Chronometer.stop().

參數(shù)

viewId????? 視圖id

base????????? ???????? 定時器應該從0:00開始讀取的時間，這個時間應該基于SystemClock.elapsedRealtime()

format????? 計時器的格式字符串，或者是簡單顯示時間的null值

started???? True表示開始，false相反

?

public void setDisplayedChild (int viewId, int childIndex)

等同于調(diào)用setDisplayedChild(int)

參數(shù)

viewId????? 要調(diào)用setDisplayedChild(int)的視圖的id

?

public void setDouble (int viewId, String methodName, double value)

為RemoteViews在視圖而已上 調(diào)用一個帶有double值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setEmptyView (int viewId, int emptyViewId)??????

相當于調(diào)用AdapterView.setEmptyView

參數(shù)

??????????????????????????? viewId????? 要設置空視圖的視圖id

??????????????????????????? emptyViewId?? 空視圖的id

?

public void setFloat (int viewId, String methodName, double value)?????

為RemoteViews在視圖而已上調(diào)用一個帶有float值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setImageViewBitmap (int viewId, Bitmap bitmap)??????

相當于調(diào)用ImageView.setImageBitmap

參數(shù)

??????????????????????????? viewId????? 視圖id

bitmap???? 用于繪制的新的Bitmap

?

public void setImageViewResource (int viewId, int srcId)?????

相當于調(diào)用ImageView. setImageResource?

參數(shù)

??????????????????????????? viewId????? 視圖id

srcId???????? ???????? 用于繪制的新的資源id

?

public void setImageViewUri (int viewId, Uri uri)??

相當于調(diào)用ImageView. setImageURI?

參數(shù)

??????????????????????????? viewId????? 視圖id

uri??? ???????? 用于繪制的新的資源uri

?

public void setInt (int viewId, String methodName, int value)???????

為RemoteViews在視圖而已上調(diào)用一個帶有int值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setIntent (int viewId, String methodName, Intent value)???

???????? （譯者注：為RemoteViews在視圖而已上調(diào)用一個帶有Intent值方法）

?

public void setLong (int viewId, String methodName, long value)

為RemoteViews在視圖而已上調(diào)用一個帶有long值方法

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName? 要調(diào)用的方法名

value???????? 要傳的值

?

public void setOnClickFillInIntent (int viewId, Intent fillInIntent)

???????? 當在widgets中使用集合（比如說ListView, StackView等等），在單獨的一個條目中設置PendingIntents是非常浪費的，并且是不被允許的。然而一個單獨的PendingIntents模板可以設置在集合里，參見setPendingIntentTemplate(int, PendingIntent)，并且一個給定條目的單獨的on-click的動作可以通過在條目上設置fillInIntent來區(qū)別。然后這個fillInIntent就和PendingIntent的實例結(jié)合在一起決定最終的被點擊執(zhí)行的intent。規(guī)定如下：在PendingIntent實例里，左邊為空白的任何區(qū)域，但由fillInIntent提供的，將被重寫，同時PendingIntent的結(jié)果將被使用。然后PendingIntent將被在fillInIntent中設置的有聯(lián)系的字段填充。參見fillIn(Intent, int)

參數(shù)

??????????????????????????? viewId????? 要設置fillInIntent視圖id

fillInIntent??????? 要和父類的PendingIntent組合在一起的意圖，用來決定被viewid指定的視圖的on- click動作

?

public void setOnClickPendingIntent (int viewId, PendingIntent pendingIntent)

相當于調(diào)setOnClickListener(android.view.View.OnClickListener)啟動準備好的PendingIntent。當在集合中設置條目的on-click動作時（比如說：ListView, StackView等），這個方法不起作用。然而，{@link RemoteViews#setPendingIntentTemplate(int, PendingIntent)應該和RemoteViews#setOnClickFillInIntent(int, Intent).一起使用

參數(shù)

??????????????????????????? viewId????? 當點擊時將要觸發(fā)PendingIntent的視圖的id

??????????????????????????? pendingIntent ? 當點擊時傳過去的PendingIntent

?

public void setPendingIntentTemplate (int viewId, PendingIntent pendingIntentTemplate)

當在widgets中使用集合(比如說ListView, StackView等等)時，在單獨的一個條目中設置PendingIntent代價是很昂貴的，因此也是不被允許的。這個方法應該在集合中設置一個單獨的PendingIntent模板,然后每一個單獨的條目都可以通過setOnClickFillInIntent(int, Intent)來區(qū)別他們的點擊事件。

參數(shù)

???????? viewId????? 當點擊時，其子視圖需要使用PendingIntent模板的集合id

???????? pendingIntentTemplate? ???????? 和viewID的一個子類綁定在一起的PendingIntent，這個孩子在點擊時會被執(zhí)行

?

public void setProgressBar (int viewId, int max, int progress, boolean indeterminate)????????

? 如果indeterminate為true的話，相當于調(diào)用ProgressBar.setMax, ProgressBar.setProgress和ProgressBar.setIndeterminate，那么最大值和進度被忽略

參數(shù)

???????? viewId????? 視圖的id

???????? max ???????? 進度條的100%時的值

???????? progress? 進度條當前的值

indeterminate ???????? 如果進度條是不確定的為true，反之為false

?

public void setRelativeScrollPosition (int viewId, int offset)

相當于調(diào)用smoothScrollToPosition(int, int).

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? offset??????? 滾動套適配器偏移位置

?

public void setRemoteAdapter (int appWidgetId, int viewId, Intent intent)

相當于調(diào)用setRemoteViewsAdapter(Intent)

參數(shù)

??????????????????????????? appWidgetId?? ???????? 包含指定視圖的app widget的id

viewId????? 視圖id

??????????????????????????? intent?????? 為RemoteViewsAdapter提供數(shù)據(jù)的服務的intent

?

public void setScrollPosition (int viewId, int position)

相當于調(diào)用smoothScrollToPosition(int, int).

參數(shù)

viewId????? 視圖id

??????????????????????????? position??? 滾動到適配器指定位置

?

public void setShort (int viewId, String methodName, short value)??????

在視圖布局上為RemoteViews調(diào)用一個帶有short值的方法。

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName?????????? 調(diào)用方法的名稱

??????????????????????????? value???????? 要傳給方法的值

?

public void setString (int viewId, String methodName, String value)?????

在視圖布局上為RemoteViews調(diào)用一個帶有String值的方法。

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName?????????? 調(diào)用方法的名稱

??????????????????????????? value???????? 要傳給方法的值

?

public void setTextColor (int viewId, int color)????????

相當于調(diào)用setTextColor(int)

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? color???????? 設置所有的狀態(tài)(normal, selected, focused)下的text顏色為指定顏色

?

public void setUri (int viewId, String methodName, Uri value)???????

在視圖布局上為RemoteViews調(diào)用一個帶有Uri值的方法。

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName?????????? 調(diào)用方法的名稱

??????????????????????????? value???????? 要傳給方法的值

??????

public void setTextViewText (int viewId, CharSequence text)????????

相當于調(diào)用setTextColor(int)

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? methodName?????????? 要調(diào)用的方法名

?

public void setViewVisibility (int viewId, int visibility)???

相當于調(diào)用view.setVisibility

參數(shù)

??????????????????????????? viewId????? 視圖id

??????????????????????????? visibility??? 這個視圖的新的可見性

?

public void showNext (int viewId)??

相當于調(diào)用showNext()

參數(shù)

??????????????????????????? viewId????? 需要調(diào)用showNext()的視圖id

?

public void showPrevious (int viewId)???

相當于調(diào)用showPrevious()。

參數(shù)

??????????????????????????? viewId????? 需要調(diào)用showPrevious()的視圖id

?

public void writeToParcel (Parcel dest, int flags)???

把一個對象填充到一個Parcel里

參數(shù)

??????????????????????????? Dest????????? ???????? 需要寫入Parcel的對象

??????????????????????????? flags????????? ???????? 這個對象應該怎樣被的標志?？赡苁?/span>0 或者PARCELABLE_WRITE_RETURN_VALUE

?

補充

???????? 文章精選

?????????????????? Android App Widget中如何調(diào)用RemoteView中的函數(shù)

?????????????????? Android widget 之RemoteView

???????? ???????? RemoteView ViewFlipper 小部件簡單動畫

?????????????????? Android:AppWidget，PendingIntent，RemoteViews用法