主要函数
public voidsetRemoteAdapter(int appWidgetId, int viewId, Intent intent)
当在widgets中使用集合(比如说ListView, StackView等等),在单独的一个条目中设置PendingIntents是非常浪费的,并且是不被允许的。然而一个单独的PendingIntents模板可以设置在集合里,参见setPendingIntentTemplate(int, PendingIntent),并且一个给定条目的单独的on-click的动作可以通过在条目上设置fillInIntent来区别。然后这个fillInIntent就和PendingIntent的实例结合在一起决定最终的被点击执行的intent。规定如下:在PendingIntent实例里,左边为空白的任何区域,但由fillInIntent提供的,将被重写,同时PendingIntent的结果将被使用。然后PendingIntent将被在fillInIntent中设置的有联系的字段填充。
public voidsetOnClickFillInIntent(int viewId, Intent fillInIntent)
当在widgets中使用集合(比如说ListView, StackView等等)时,在单独的一个条目中设置PendingIntent代价是很昂贵的,因此也是不被允许的。这个方法应该在集合中设置一个单独的PendingIntent模板,然后每一个单独的条目都可以通过setOnClickFillInIntent(int, Intent)来区别他们的点击事件。
public voidsetPendingIntentTemplate(int viewId, PendingIntent pendingIntentTemplate)
1.布局文件
在Mantifest中:
<receiver android:name=".CustomWidget">
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/custom_widget">
</meta-data>
</receiver>
在res/xml/下建立custom_widget.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<appwidget-provider
xmlns:android = "http://schemas.android.com/apk/res/android"
android:minWidth="xxxdp"
android:minHeight="xxxdp"
android:updatePeriodMillis="0"
android:initialLayout="@layout/widget_layout"> <!--最小宽度、高度及更新周期自行设定-->
</appwidget-provider>
在res/layout/下建立widget_layout布局文件
<LinearLayout ...>
<ListView
android:id="@+id/widget_list"
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
...
</LinearLayout>
CustomWidget.java
public class CustomWidget extends AppWidgetProvider {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
RemoteView remoteViews = new RemoteViews(context.getPackageName(),
R.layout.widget_layout);
Intent intent = new Intent(context, UpdateService.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetIds[0]);
// 远程RemoteViews的ListView设置适配器
// R.id.widget_list是ListView的id
remoteViews.setRemoteAdapter(R.id.widget_list, intent);
// 设置OnItemClick事件,跳转至xxxActivity,这只是第一步,还需要第二步在service中拼接intent
Intent intent2 = new Intent(context, xxxActivity.class);
PendingIntent pendingIntentTemplate = PendingIntent.getActivity(
context, 1, intent2, PendingIntent.FLAG_UPDATE_CURRENT);
remoteViews.setPendingIntentTemplate(R.id.widget_list,
pendingIntentTemplate);
ComponentName thisWidget = new ComponentName(context,
CustomWidget.class);
appWidgetManager.updateAppWidget(thisWidget, remoteViews);
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
}
UpdateService.java
public class UpdateService extends RemoteViewsService {
@Override
public IBinder onBind(Intent intent) {
return super.onBind(intent);
}
@Override
public RemoteViewsFactory onGetViewFactory(Intent intent) {
return new ListRemoteViewsFactory(this.getApplicationContext(), intent);
}
class ListRemoteViewsFactory implements RemoteViewsService.RemoteViewsFactory{
private Context mContext
public ListRemoteViewsFactory(Context context, Intent intent){
mContext = context;
}
@Override
public void onCreate() {
}
@Override
public void onDataSetChanged() {
}
@Override
public void onDestroy() {
}
@Override
public int getCount() {
return collection.size();
}
@Override
public RemoteViews getViewAt(int position) {
//ListView的item的自定义布局文件
RemoteViews rv = new RemoteViews(mContext.getPackageName(), R.layout.widget_list_item);
//拼接intent,与CustomWidget中设置的setPendingIntentTemplate共同使用
Intent intent = new Intent();
rv.setOnClickFillInIntent(R.id.widget_layout, intent);//R.id.widget_layout是listView的item的布局id
//...
return rv;
}
@Override
public RemoteViews getLoadingView() {
//返回空时,按默认显示”正在加载数据“
return null;
}
@Override
public int getViewTypeCount() {
return 1;
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public boolean hasStableIds() {
return true;
}
}
}