构建应用程序窗口小部件(App Widget)

一、在Manifast.xml文件中声明你自定义的AppWidgetProvider:

<receiver android:name="ExampleAppWidgetProvider" >
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/example_appwidget_info" />
</receiver>

receiver name 属性为自定义的类,需继承 AppWidgetProvider,resource 属性指明AppWidgetProviderInfo所在的文件位置;该类对小部件的基本属性做定义。


二、在res文件夹下新建xml文件夹,新建metadata resource属性指定的文件:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:updatePeriodMillis="86400000"
    android:previewImage="@drawable/preview"
    android:initialLayout="@layout/example_appwidget"
    android:configure="com.example.android.ExampleAppWidgetConfigure"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen">
</appwidget-provider>


minWidth与minHeight属性表示了App Widget所需的最小布局区域。 

updatePeriodMillis属性定义了App 
Widget框架调用AppWidgetProvider的onUpdate方法的频率。

linitialLayout属性标识了初始布局文件。

configure属性定义了当用户添加App Widget时调用的Activity。(这是可选的)

previewImage定义了App Widget的缩略图,当用户从widget列表中选择时,显示的就是这张图。如果没设置,用户将看见的是你的应用的默认图标。

resizeMode属性标识了widget重新布局的规则。


三、在layout文件夹下新建initialLayout属性值指定的xml文件,定义widget的布局:

<FrameLayout
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:padding="@dimen/widget_margin">

  <LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    android:background="@drawable/my_widget_background">
    …
  </LinearLayout>

</FrameLayout>

四、实现自定义的AppWidgetProvider类,覆盖其中的方法:
onEnabled():小部件第一次创建的时候调用;
onUpdate():小部件更新时调用,如用户添加小部件的时候,指定的更新时间到的时候;
onDeleted():删除一个小部件时调用;
onDisabled():最后一个小部件被删除时调用。



评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值