appwidget-provider

android:initialLayout="@layout/example_appwidget"android

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

  < /appwidget-provider>框架

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

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

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

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

  (number of cells * 74) - 2對象

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

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

  · 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)能夠支持下面這個佈局類:

相關文章
相關標籤/搜索