Android(安卓)4.0 新增的显示数据集的桌面控件

setRemoteAdapter (int viewId, Intent intent)：该方法可以使用 Intent 更新 RemoteViews 中viewId 对应的组件。

上面方法的 Intent 参数应该封装一个 RemoteViewsService 参数，RemoteViewsService 虽然继承了 Service 组件，但它的主要作用是为 RemoteViews 中 viewId 对应的组件提供列表项。

由于Intent参数负责提供列表项，因此viewId参数对应的组件可以是ListView、GridView、StackView 和 AdapterViewFlipper 等，这些组件都是 AdapterView 的子类，由此可见RemoteViewsService 负责提供的对象，应该是一个类似于 Adapter 的对象。

RemoteViewsService 通常用于被继承，继承该基类时需要重写它的 onGetViewFactory()方法，该方法就需要返回一个类似于 Adapterr 对象 —— 但不是 Adapter ，而是RemoteViewsFactory 对象，RemoteViewsFactory 的功能完全类似于 Adapter。

StackViewWidget实现如下：

StackWidgetService.java

package org.crazyit.desktop;import android.content.Context;import android.content.Intent;import android.widget.RemoteViews;import android.widget.RemoteViewsService;/** * Description: * <br/>网站: <a href="http://www.crazyit.org">疯狂Java联盟</a> * <br/>Copyright (C), 2001-2014, Yeeku.H.Lee * <br/>This program is protected by copyright laws. * <br/>Program Name: * <br/>Date: * @author Yeeku.H.Lee kongyeeku@163.com * @version 1.0 */public class StackWidgetService extends RemoteViewsService{    // 重写该方法，该方法返回一个RemoteViewsFactory对象。    // RemoteViewsFactory对象的的作用类似于Adapter，    // 它负责为RemoteView中指定组件提供多个列表项。    @Override    public RemoteViewsFactory onGetViewFactory(Intent intent)    {        return new StackRemoteViewsFactory(this.getApplicationContext(),            intent);  //①    }    class StackRemoteViewsFactory implements    RemoteViewsService.RemoteViewsFactory    {        // 定义一个数组来保存该组件生成的多个列表项        private int[] items = null;        private Context mContext;        public StackRemoteViewsFactory(Context context, Intent intent)        {            mContext = context;        }        @Override        public void onCreate()        {            // 初始化items数组            items = new int[] { R.drawable.bomb5, R.drawable.bomb6,                R.drawable.bomb7, R.drawable.bomb8, R.drawable.bomb9,                R.drawable.bomb10, R.drawable.bomb11, R.drawable.bomb12,                R.drawable.bomb13, R.drawable.bomb14, R.drawable.bomb15,                R.drawable.bomb16            };        }        @Override        public void onDestroy()        {            items = null;        }        // 该方法的返回值控制该对象包含多少个列表项        @Override        public int getCount()        {            return items.length;        }        // 该方法的返回值控制各位置所显示的RemoteViews        @Override        public RemoteViews getViewAt(int position)        {            // 创建RemoteViews对象，加载/res/layout目录下widget_item.xml文件            RemoteViews rv = new RemoteViews(mContext.getPackageName(),                R.layout.widget_item);            // 更新widget_item.xml布局文件中的widget_item组件            rv.setImageViewResource(R.id.widget_item,                items[position]);            // 创建Intent、用于传递数据            Intent fillInIntent = new Intent();            fillInIntent.putExtra(StackWidgetProvider.EXTRA_ITEM, position);            // 设置当单击该RemoteViews时传递fillInIntent包含的数据            rv.setOnClickFillInIntent(R.id.widget_item, fillInIntent);            // 此处使用让线程暂停0.5秒来模拟加载该组件            try            {                System.out.println("加载【" + position + "】位置的组件");                Thread.sleep(500);            }            catch (InterruptedException e)            {                e.printStackTrace();            }            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;        }        @Override        public void onDataSetChanged()        {        }    }    }

widget_item.xml

<?xml version="1.0" encoding="utf-8"?><ImageView xmlns:android="http://schemas.android.com/apk/res/android"    android:id="@+id/widget_item"    android:layout_width="120dp"    android:layout_height="120dp"    android:gravity="center"/>

StackWidgetProvider.java

package org.crazyit.desktop;import android.app.PendingIntent;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.ComponentName;import android.content.Context;import android.content.Intent;import android.widget.RemoteViews;import android.widget.Toast;/** * Description: * <br/>网站: <a href="http://www.crazyit.org">疯狂Java联盟</a> * <br/>Copyright (C), 2001-2014, Yeeku.H.Lee * <br/>This program is protected by copyright laws. * <br/>Program Name: * <br/>Date: * @author Yeeku.H.Lee kongyeeku@163.com * @version 1.0 */public class StackWidgetProvider extends AppWidgetProvider{    public static final String TOAST_ACTION        = "org.crazyit.desktop.TOAST_ACTION";    public static final String EXTRA_ITEM         = "org.crazyit.desktop.EXTRA_ITEM";    @Override    public void onUpdate(Context context,        AppWidgetManager appWidgetManager, int[] appWidgetIds)    {        // 创建RemoteViews对象，加载/res/layout目录下的widget_layout.xml文件        RemoteViews rv = new RemoteViews(context.getPackageName(),            R.layout.widget_layout);        Intent intent = new Intent(context, StackWidgetService.class);        // 使用intent更新rv中stack_view组件（StackView）        rv.setRemoteAdapter(R.id.stack_view, intent);  //①        // 设置当StackWidgetService提供的列表项为空时，直接显示empty_view组件        rv.setEmptyView(R.id.stack_view, R.id.empty_view);        // 创建启动StackWidgetProvider组件（作为BroadcastReceiver）的Intent        Intent toastIntent = new Intent(context,            StackWidgetProvider.class);        // 为该Intent设置Action属性        toastIntent.setAction(StackWidgetProvider.TOAST_ACTION);        // 将Intent包装成PendingIntent        PendingIntent toastPendingIntent = PendingIntent            .getBroadcast(context, 0, toastIntent,                PendingIntent.FLAG_UPDATE_CURRENT);        // 将PendingIntent与stack_view进行关联        rv.setPendingIntentTemplate(R.id.stack_view,            toastPendingIntent);        // 使用AppWidgetManager通过RemteViews更新AppWidgetProvider        appWidgetManager.updateAppWidget(            new ComponentName(context, StackWidgetProvider.class), rv); //②        super.onUpdate(context, appWidgetManager, appWidgetIds);    }    @Override    public void onDeleted(Context context, int[] appWidgetIds)    {        super.onDeleted(context, appWidgetIds);    }    @Override    public void onDisabled(Context context)    {        super.onDisabled(context);    }    @Override    public void onEnabled(Context context)    {        super.onEnabled(context);    }    // 重写该方法，将该组件当成BroadcastReceiver使用    @Override    public void onReceive(Context context, Intent intent)    {        if (intent.getAction().equals(TOAST_ACTION))        {            // 获取Intent中的数据            int viewIndex = intent.getIntExtra(EXTRA_ITEM, 0);            // 显示Toast提示            Toast.makeText(context, "点击第【" + viewIndex + "】个列表项",                Toast.LENGTH_SHORT).show();        }        super.onReceive(context, intent);    }    }

widget_layout.xml

<?xml version="1.0" encoding="utf-8"?><FrameLayout    xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:layout_margin="8dp">    <StackView        android:id="@+id/stack_view"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:gravity="center"        android:loopViews="true" />    <TextView        android:id="@+id/empty_view"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:gravity="center"        android:background="#ff0f"        android:textColor="#ffffff"        android:textStyle="bold"        android:text="@string/no_item"        android:textSize="20sp" /></FrameLayout>

Manifest.xml

<?xml version="1.0" encoding="utf-8" ?><manifest    xmlns:android="http://schemas.android.com/apk/res/android"    package="org.crazyit.desktop"    android:versionCode="1"    android:versionName="1.0">    <uses-sdk        android:minSdkVersion="14"        android:targetSdkVersion="17" /><application    android:allowBackup="true"    android:label="@string/app_name">    <!-- 配置AppWidgetProvider，即配置桌面控件 -->    <receiver android:name=".StackWidgetProvider">        <!-- 通过该intent-filter指定该Receiver作为桌面控件 -->        <intent-filter>            <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />        </intent-filter>        <!-- 为桌面控件指定meta-data -->        <meta-data            android:name="android.appwidget.provider"            android:resource="@xml/stackwidgetinfo" />    </receiver>    <!-- 配置RemoteViewsService    必须指定权限为android.permission.BIND_REMOTEVIEWS     -->    <service        android:name=".StackWidgetService"        android:permission="android.permission.BIND_REMOTEVIEWS"        android:exported="false" /></application></manifest>

stackwidgetinfo.xml

<?xml version="1.0" encoding="utf-8"?><appwidget-provider    xmlns:android="http://schemas.android.com/apk/res/android"    android:minWidth="110dp"    android:minHeight="110dp"    android:updatePeriodMillis="3600000"    android:previewImage="@drawable/ic_launcher"    android:initialLayout="@layout/widget_layout"    android:resizeMode="horizontal|vertical"    android:autoAdvanceViewId="@id/stack_view"></appwidget-provider>

截图：

更多相关文章

随机推荐