天天看點

建構應用程式視窗小部件(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():最後一個小部件被删除時調用。