RemoteViews

版本：Android 4.0 r1

?

結(jié)構(gòu)

繼承關(guān)系

public class RemoteViews extends Object implements Parcelable,LayoutInflater.Filter

????????

java.lang.Object

android.widget.RemoteViews

?

類概述

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

????????

字段

public static final Creator<RemoteViews>

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

?

內(nèi)部類

class? RemoteViews.ActionException

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

?

@interface? RemoteViews.RemoteView

這個(gè)標(biāo)記指明View的子類可以使用RemoteViews機(jī)制

?

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

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

???????? 通過指定的布局文件新建一個(gè)RemoteViews對(duì)象。

????????

public RemoteViews(Parcel parcel)

從一個(gè)parcel中讀取RemoteViews對(duì)象。

?

公共方法

public void addView (int viewId, RemoteViews nestedView)

???????? 相當(dāng)于當(dāng)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視圖對(duì)象并且應(yīng)用到所有的動(dòng)作中。

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

參數(shù)

??????????????????????????? Context??? 默認(rèn)使用的context

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

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

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

?

public RemoteViews clone ()

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

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

??????????????????????????? 對(duì)象的復(fù)本。

?

public int describeContents ()

???????? 描述對(duì)象在Parcelable中特定的編碼形式

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

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

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

public int getLayoutId ()

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

?

public String getPackage ()

?

?

public boolean onLoadClass (Class clazz)

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

參數(shù)

??????????????????????????? clazz???????? ???????? 用來inflated的視圖對(duì)象

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

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

?

public void reapply (Context context, View v)

???????? 為視圖對(duì)象應(yīng)用所有的動(dòng)作

參數(shù)

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

?

public void removeAllViews (int viewId)

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

參數(shù)

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

?

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

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

參數(shù)

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

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

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

????????

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

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

參數(shù)

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

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

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

????????

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

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

參數(shù)

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

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

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

????????

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

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

參數(shù)

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

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

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

?

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

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

參數(shù)

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

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

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

?

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

為RemoteViews在視圖而已上調(diào)用一個(gè)帶有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????????? ???????? 定時(shí)器應(yīng)該從0:00開始讀取的時(shí)間，這個(gè)時(shí)間應(yīng)該基于SystemClock.elapsedRealtime()

format????? 計(jì)時(shí)器的格式字符串，或者是簡單顯示時(shí)間的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)用一個(gè)帶有double值方法

參數(shù)

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

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

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

?

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

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

參數(shù)

??????????????????????????? viewId????? 要設(shè)置空視圖的視圖id

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

?

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

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

參數(shù)

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

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

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

?

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

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

參數(shù)

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

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

?

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

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

參數(shù)

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

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

?

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

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

參數(shù)

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

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

?

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

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

參數(shù)

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

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

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

?

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

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

?

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

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

參數(shù)

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

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

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

?

public void setOnClickFillInIntent (int viewId, Intent fillInIntent)

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

參數(shù)

??????????????????????????? viewId????? 要設(shè)置fillInIntent視圖id

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

?

public void setOnClickPendingIntent (int viewId, PendingIntent pendingIntent)

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

參數(shù)

??????????????????????????? viewId????? 當(dāng)點(diǎn)擊時(shí)將要觸發(fā)PendingIntent的視圖的id

??????????????????????????? pendingIntent ? 當(dāng)點(diǎn)擊時(shí)傳過去的PendingIntent

?

public void setPendingIntentTemplate (int viewId, PendingIntent pendingIntentTemplate)

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

參數(shù)

???????? viewId????? 當(dāng)點(diǎn)擊時(shí)，其子視圖需要使用PendingIntent模板的集合id

???????? pendingIntentTemplate? ???????? 和viewID的一個(gè)子類綁定在一起的PendingIntent，這個(gè)孩子在點(diǎn)擊時(shí)會(huì)被執(zhí)行

?

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

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

參數(shù)

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

???????? max ???????? 進(jìn)度條的100%時(shí)的值

???????? progress? 進(jìn)度條當(dāng)前的值

indeterminate ???????? 如果進(jìn)度條是不確定的為true，反之為false

?

public void setRelativeScrollPosition (int viewId, int offset)

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

參數(shù)

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

??????????????????????????? offset??????? 滾動(dòng)套適配器偏移位置

?

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

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

參數(shù)

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

viewId????? 視圖id

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

?

public void setScrollPosition (int viewId, int position)

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

參數(shù)

viewId????? 視圖id

??????????????????????????? position??? 滾動(dòng)到適配器指定位置

?

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

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

參數(shù)

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

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

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

?

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

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

參數(shù)

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

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

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

?

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

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

參數(shù)

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

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

?

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

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

參數(shù)

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

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

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

??????

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

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

參數(shù)

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

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

?

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

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

參數(shù)

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

??????????????????????????? visibility??? 這個(gè)視圖的新的可見性

?

public void showNext (int viewId)??

相當(dāng)于調(diào)用showNext()

參數(shù)

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

?

public void showPrevious (int viewId)???

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

參數(shù)

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

?

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

把一個(gè)對(duì)象填充到一個(gè)Parcel里

參數(shù)

??????????????????????????? Dest????????? ???????? 需要寫入Parcel的對(duì)象

??????????????????????????? flags????????? ???????? 這個(gè)對(duì)象應(yīng)該怎樣被的標(biāo)志?？赡苁?/span>0 或者PARCELABLE_WRITE_RETURN_VALUE

?

補(bǔ)充

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

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

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

???????? ???????? RemoteView ViewFlipper 小部件簡單動(dòng)畫

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