appwidget-provider

android:initialLayout="@layout/example_appwidget"

  android:configure="com.example.android.ExampleAppWidgetConfigure" >

  < /appwidget-provider>

  下面是< appwidget-provider>屬性的總結:

  · minWidth 和minHeight 屬性的值指定了這個App Widget佈局需要的最小區域。

  缺省的App Widgets所在窗口的桌面位置基於有確切高度和寬度的單元網格。如果App Widget的最小長寬和這些網格單元的尺寸不匹配,那麼這個App Widget將收縮到最接近的單元尺寸。(參見App Widget Design Guidelines 以獲取更多關於桌面單元尺寸的信息)

  因爲桌面佈局方向(由此,單元的尺寸)可以變化,按照拇指規則,你應該假設最壞情況單元尺寸是74像素高和寬。不過,你必須從最後的尺寸中減去2以把像素計算過程中產生的任何的整數舍入誤差考慮在內。要找到像素密度無關的最小寬度和高度,使用這個公式:

  (number of cells * 74) - 2

  遵循這個公式,你應該使用72dp爲每一個單元高度,294dp爲四個單元寬度。

  · updatePerdiodMillis 屬性定義了App Widget框架調用onUpdate()方法來從AppWidgetProvider請求一次更新的頻度。實際更新時間並不那麼精確,而且我們建議更新頻率越低越好-也許每小時不超過一次以節省電源。你也許還會允許用戶在配置中調整這個頻率-一些人可能想每15分鐘一次股票報價,或者一天只要四次。

  · initialLayout屬性指向定義App Widget佈局的資源。

  · configure屬性定義了Activity ,當用戶添加App Widget時啓動,以爲他或她配置App Widget特性。這是可選的(閱讀下面的Creating an App Widget Configuration Activity)。

  參見AppWidgetProviderInfo 類以獲取更多可以被< appwidget-provider>元素接受的屬性信息。

  創建App Widget佈局

  你必須在XML中爲你的App Widget定義一個初始佈局並保存到項目的res/layout/ 目錄下。你可以使用如下所列的視圖對象來設計你的App Widget,但是在此之前,請先閱讀並理解App Widget Design Guidelines.

  如果你熟悉在XML中聲明佈局,那麼創建這個App Widget佈局是很簡單的。但是,你必須意識到那個App Widget佈局是基於RemoteViews, 這並不支持所有類型的佈局或視圖小部件。

  一個RemoteViews對象(以及,相應的,一個App Widget)可以支持下面這個佈局類:

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章