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)可以支持下面这个布局类：

更多相关文章

随机推荐