Android 之窗口小部件高级篇--App Widget 之 RemoteViews - 跨到对岸去
? 在之前的一篇博文(?Android 之窗口小部件詳解--App Widge?t)中,已經介紹了App Widget的基本用法和簡單實例。這篇主要講解 App Widget 的高級內容,即通過 RemoteViews 去管理Widget的中GridView、ListView、StackView等內容。在學習本篇之前,建議讀者先掌握 App Widget 的基本知識。
?
1 RemoteViews等相關類的介紹
下面先簡單介紹RemoteViews、RemoteViewsService、RemoteViewsFactory。
1.1 RemoteViews
? ? 顧名思義,它是一個遠程視圖。App Widget中的視圖,都是通過RemoteViews表現的。?
? ? 在RemoteViews的構造函數中,通過傳入layout文件的id來獲取 “layout文件對應的視圖(RemoteViews)”;然后,調用RemoteViews中的方法能對layout中的組件進行設置(例如,可以調用setTextViewText()來設置TextView組件的文本,可以調用setOnClickPendingIntent() 來設置Button的點擊響應事件)。
? ? 因此,我們可以將 “RemoteViews 看作是 layout文件中所包含的全部視圖的集合”。
1.2 RemoteViewsService
? ? RemoteViewsService,是管理RemoteViews的服務。?
? ? 一般,當App Widget 中包含“GridView、ListView、StackView等”集合視圖時,才需要使用RemoteViewsService來進行更新、管理。(集合視圖是指GridView、ListView、StackView等包含子元素的視圖)?
? ? RemoteViewsService更新“集合視圖”的一般步驟是:?
(01) 通過setRemoteAdapter來設置 “RemoteViews對應RemoteViewsService”。?
(02) 之后在RemoteViewsService中,實現RemoteViewsFactory接口。然后,在RemoteViewsFactory接口中對“集合視圖”的各個子項進行設置(“集合視圖”的各個子項:例如,GridView的每一個格子都是一個子項;ListView中的每一列也是一個子項)。
? ? 因此,我們可以將 “RemoteViewsService 看作是 管理layout中集合視圖的服務”。
1.3 RemoteViewsFactory
? ? 通過RemoteViewsService中的介紹,我們可以了解“RemoteViewsService是通過RemoteViewsFactory來具體管理layout中集合視圖的”,即“RemoteViewsFactory管理集合視圖的實施者”。?
? ? RemoteViewsFactory是RemoteViewsService中的一個接口。RemoteViewsFactory提供了一系列的方法管理“集合視圖”中的每一項。例如:?
(01)RemoteViews getViewAt(int position)?
? ? ? 通過getViewAt()來獲取“集合視圖”中的第position項的視圖,視圖是以RemoteViews的對象返回的。?
(02)int getCount()?
? ? ? 通過getCount()來獲取“集合視圖”中所有子項的總數。
? ? 因此,我們可以將 “RemoteViewsFactory 看作是 layout中集合視圖管理的具體實施者”。
2 實例介紹
? ? 實現一個App Widget,App Widget可縮放,且包含“3個組成部分”。?
第1部分:是一個TextView文本,標題內容是“Sky Wang”。?
第2部分:是一個Button按鈕。點擊按鈕,會彈出一個Toast提示框,提示響應了Button點擊事件。?
第3部分:是一個GridView視圖。GridView的每一個格子包含“圖片”和“文本”兩部分數據。點擊GridView中的每一個格子,會彈出響應的提示語。
manifest代碼如下?:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.skywang.test" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="14" android:targetSdkVersion="17" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <receiver android:name=".GridWidgetProvider"> <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> <!-- GridWidgetProvider接收點擊gridview的響應事件 --> <action android:name="com.skywang.test.COLLECTION_VIEW_ACTION" /> <!-- GridWidgetProvider接收點擊bt_refresh的響應事件 --> <action android:name="com.skywang.test.BT_REFRESH_ACTION" /> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/widget_provider"/> </receiver> <service android:name=".GridWidgetService" android:permission="android.permission.BIND_REMOTEVIEWS" /> </application> </manifest>說明:?
(01)?GridWidgetProvider.java?是?AppWidgetProvider的繼承類?,而且AppWidgetProvider的配置文件是?widget_provider.xml?。?
(02)?GridWidgetProvider.java?除了?響應 App Widget 的更新事件?(android.appwidget.action.APPWIDGET_UPDATE)之外;?
? ? ? ?也會“?響應App Widget包含的GridView的點擊事件?(com.skywang.test.COLLECTION_VIEW_ACTION) ”??和“?App Widget包含的按鈕的點擊事件?(com.skywang.test.BT_REFRESH_ACTION) ”。?
(03)?GridWidgetService.java?是?RemoteViewsService的繼承類?。
widget_provider.xml代碼如下?:?
widget_provider.xml是AppWidgetProvider對應配置文件
說明:?
(01)?android:minWidth="180dp"?? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? 表明 "?Widget支持的最小寬度是3格?"?
(02)?android:minHeight="180dp"?? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? 表明 "?Widget支持的最小高度是3格?"?
(03)?android:initialLayout="@layout/widget_layout"?表明 "?Widget對應的布局文件是widget_layout.xml?"?
(04)?android:previewImage="@drawable/preview" ? ??表明 "?Widget對應的預覽圖片是preview.png?"?
(05)?android:resizeMode="horizontal|vertical" ? ? ? ? ??表明 "?Widget支持水平和豎直伸縮?"?
(06)?android:widgetCategory="home_screen"?? ? ? ? ? ?表明 "?Widget只能添加到桌面上,而不能添加到鎖屏界面上?"
?
widget_layout.xml代碼如下?:?
widget_layout.xml是App Widget的布局文件
GridWidgetProvider.java代碼如下?:?
GridWidgetProvider.java是AppWidgetProvider的繼承類
說明:?
(01)?RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.widget_layout);?
? ? ?通過上面的語句,?獲取widget_layout.xml對應的 RemoteViews?;進而通過RemoteViews對 widget_layout.xml中的各個元素進行管理。?
(02)?rv.setOnClickPendingIntent(R.id.bt_refresh, btPendingIntent);?
? ? ?通過上面的語句,設置?點擊“按鈕(bt_refresh)”時會觸發的Intent?。從而對按鈕點擊事件進行處理。?
(03)?rv.setRemoteAdapter(R.id.gridview, serviceIntent);?
? ? 通過上面的語句,?設置 “GridView(gridview)” 的遠程適配器?,serviceIntent是 GridWidgetService 的Intent。?
? ? 從而在通過GridWidgetService對gridview進行管理。?
(04)?PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, gridIntent, PendingIntent.FLAG_UPDATE_CURRENT);?
? ? 通過上面的語句,設置響應 “GridView(gridview)” 點擊事件的?intent模板?。關于“Intent模板”,后面在"?關于'GridView'的點擊事件?"會詳細說明。?
(05)?if (action.equals(COLLECTION_VIEW_ACTION)) ...?
? ? 通過上面的語句,響應“GridView”的點擊事件。?
(06)?if (action.equals(BT_REFRESH_ACTION)) ...?
? ? 通過上面的語句,響應“按鈕(bt_refresh)”的點擊事件。
?
關于 “GridView”的點擊事件。這里詳細說明以下!
? ? 像GridView這樣的集合控件,不能單單像按鈕一樣,通過setOnClickPendingIntent() 來設置它的點擊事件的Intent;而要通過以下兩步來進行。?
? ??第一,設置GridView的點擊響應事件的“Intent模板”。?
? ? ? ? ? ? ? 這是通過?setPendingIntentTemplate()?來進行設置的。?
? ? ? ? ? ? ? 這樣做的目的有兩個:首先,?設置Intent模板。?因為GridView有許多子項,它們這些子項都?統一?的要響應父親的?Intent模板?。其次,?傳遞附件參數(例如,App Widget的ID)?,因為App Widget可以設置許多widget,每一個Widget的ID都不同,而且它們顯示的內容可能不同(例如,不同大小的Widget顯示不同大小的文字)。?
? ? 第二,?設置GridView子項的點擊響應事件的Intent。?
? ? ? ? ? ? ? 設置通過?setOnClickFillInIntent()?來進行設置的。?
? ? ? ? ? ? ? 這樣做的首要目的,是?設置 GridView的子項所包含的信息?(例如,點擊的?GridView子項的索引值?)。?
? ? ? ? ? ? ? 通過這兩步的設置之后,點擊GridView中具體每一項的所產生的事件就是?“第一”和“第二”步中Intent的合集(組合)?。也就是說,?點擊“GridView中某一個子項”所產生的Intent,同時包含了“通過?setPendingIntentTemplate?傳遞的Intent數據”和“通過?setOnClickFillInIntent?傳遞的Intent數據”?。?理解這一點對理解這個RemoteView的原理至關重要!!!
GridWidgetService.java的代碼如下:
package com.skywang.test;import android.app.PendingIntent; import android.appwidget.AppWidgetManager; import android.content.Context; import android.content.Intent; import android.widget.RemoteViews; import android.widget.RemoteViewsService; import android.util.Log; import java.util.List; import java.util.ArrayList; import java.util.HashMap; public class GridWidgetService extends RemoteViewsService{ private static final String TAG = "SKYWANG"; @Override public RemoteViewsService.RemoteViewsFactory onGetViewFactory(Intent intent) { Log.d(TAG, "GridWidgetService"); return new GridRemoteViewsFactory(this, intent); } private class GridRemoteViewsFactory implements RemoteViewsService.RemoteViewsFactory { private Context mContext; private int mAppWidgetId; private String IMAGE_ITEM = "imgage_item"; private String TEXT_ITEM = "text_item"; private ArrayList<HashMap<String, Object>> data ; private String[] arrText = new String[]{ "Picture 1", "Picture 2", "Picture 3", "Picture 4", "Picture 5", "Picture 6", "Picture 7", "Picture 8", "Picture 9" }; private int[] arrImages=new int[]{ R.drawable.p1, R.drawable.p2, R.drawable.p3, R.drawable.p4, R.drawable.p5, R.drawable.p6, R.drawable.p7, R.drawable.p8, R.drawable.p9 }; /** * 構造GridRemoteViewsFactory * @author skywang */ public GridRemoteViewsFactory(Context context, Intent intent) { mContext = context; mAppWidgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); Log.d(TAG, "GridRemoteViewsFactory mAppWidgetId:"+mAppWidgetId); } @Override public RemoteViews getViewAt(int position) { HashMap<String, Object> map; Log.d(TAG, "GridRemoteViewsFactory getViewAt:"+position); // 獲取 grid_view_item.xml 對應的RemoteViews RemoteViews rv = new RemoteViews(mContext.getPackageName(), R.layout.grid_view_item); // 設置 第position位的“視圖”的數據 map = (HashMap<String, Object>) data.get(position); rv.setImageViewResource(R.id.itemImage, ((Integer)map.get(IMAGE_ITEM)).intValue()); rv.setTextViewText(R.id.itemText, (String)map.get(TEXT_ITEM)); // 設置 第position位的“視圖”對應的響應事件 Intent fillInIntent = new Intent(); fillInIntent.putExtra(GridWidgetProvider.COLLECTION_VIEW_EXTRA, position); rv.setOnClickFillInIntent(R.id.itemLayout, fillInIntent); return rv; } /** * 初始化GridView的數據 * @author skywang */ private void initGridViewData() { data = new ArrayList<HashMap<String, Object>>(); for (int i=0; i<9; i++) { HashMap<String, Object> map = new HashMap<String, Object>(); map.put(IMAGE_ITEM, arrImages[i]); map.put(TEXT_ITEM, arrText[i]); data.add(map); } } @Override public void onCreate() { Log.d(TAG, "onCreate"); // 初始化“集合視圖”中的數據 initGridViewData(); } @Override public int getCount() { // 返回“集合視圖”中的數據的總數 return data.size(); } @Override public long getItemId(int position) { // 返回當前項在“集合視圖”中的位置 return position; } @Override public RemoteViews getLoadingView() { return null; } @Override public int getViewTypeCount() { // 只有一類 GridView return 1; } @Override public boolean hasStableIds() { return true; } @Override public void onDataSetChanged() { } @Override public void onDestroy() { data.clear(); } } }說明:?
(01)?public RemoteViewsService.RemoteViewsFactory onGetViewFactory(Intent intent) ...?
? ? ? ?通過上面的語句,返回一個RemoteViewsFactory對象。?
? ? ? ?RemoteViewsService是一個服務,通過之前對RemoteViewsService的介紹。我們知道,它 管理layout中集合視圖的服務。?
? ? ? ?RemoteViewsService管理layout中集合視圖的服務,是通過 RemoteViewsFactory 實現的;那么它是如何實現的呢??
? ? ? ?RemoteViewsService是“通過 onGetViewFactory() 接口返回一個 RemoteViewsFactory 對象” 來實現的。?
(02)?public void onCreate() ...?
? ? ? ?在onCreate()中進行?RemoteViewsFactory 的初始化工作?。?
(03)?public int getCount() ...?
? ? ? ?通過getCount()返回?“集合視圖”中的數據項的總數。?
(04)?public RemoteViews getViewAt(int position) ...?
? ? ? ?通過上面的語句,返回?一個“集合視圖”中具體每一項的視圖。?
? ? ? ?getViewAt()是非常重要的函數!?我們對"集合視圖"中每一項的初始化都是在getViewAt()中進行設置的?。?
grid_view_item.xml的代碼如下:
<?xml version="1.0" encoding="utf-8"?> <RelativeLayoutxmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/itemLayout" android:layout_height="match_parent" android:layout_width="match_parent"> <ImageView android:id="@+id/itemImage" android:layout_width="80dip" android:layout_height="60dip" android:layout_centerHorizontal="true" android:scaleType="fitXY" /> <TextView android:id="@+id/itemText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_below="@+id/itemImage" android:layout_centerHorizontal="true" android:text="TextView01"/> </RelativeLayout>點擊下載:?源代碼
點擊查看更多內容:?
1.?Android 之窗口小部件詳解--App Widget?
2.?sky wang博客索引
實例效果圖:
?
轉載于:https://www.cnblogs.com/Free-Thinker/p/4422415.html
總結
以上是生活随笔為你收集整理的Android 之窗口小部件高级篇--App Widget 之 RemoteViews - 跨到对岸去的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 如何理解Java中参数传递只能传值?
- 下一篇: B表中的pid对应A表中id,查询A表中