diff --git a/docs/html/guide/topics/appwidgets/index.jd b/docs/html/guide/topics/appwidgets/index.jd index 2cb23c1cdbbab..7b869a09b9fe6 100644 --- a/docs/html/guide/topics/appwidgets/index.jd +++ b/docs/html/guide/topics/appwidgets/index.jd @@ -186,36 +186,34 @@ folder.
Here's a summary of the <appwidget-provider> attributes:
minWidth and minHeight
-attributes specify the minimum
- area required by the App Widget's layout.
- The default Home screen positions App Widgets in its window based on a -grid of - cells that have a defined height and width. If the values for an App -Widget's minimum width - or height don't match the dimensions of the cells, - then the App Widget dimensions round up to the nearest cell size. - (See the App Widget -Design - Guidelines for more information on the Home screen cell sizes.)
-Because the Home screen's layout orientation (and thus, the cell sizes)
-can change,
- as a rule of thumb, you should assume the worst-case cell size of 74 pixels
-for the height
- and width of a cell. However, you must subtract 2 from the final
-dimension to account
- for any integer rounding errors that occur in the pixel count. To find your
-minimum width
- and height in density-independent pixels (dp), use this formula:
- (number of cells * 74) - 2
- Following this formula, you should use 72 dp for a height of one cell, 294
-dp and for a width of four cells.
Note: To make your app widget portable across -devices, your app widget's minimum size should never be larger than 4 x 4 cells. -See the App -Widget Design Guidelines for more discussion of Home screen cell sizes.
+ attributes specify the minimum amount of space the App Widget consumes + by default. The default Home screen positions App Widgets in its + window based on a grid of cells that have a defined height and width. If + the values for an App Widget's minimum width or height don't match the + dimensions of the cells, then the App Widget dimensions round + up to the nearest cell size. +See the + App Widget Design Guidelines for more information on sizing your App + Widgets.
+ +Note: To make your app widget portable + across devices, your app widget's minimum size should never be larger + than 4 x 4 cells.
minResizeWidth and minResizeHeight attributes
+ specify the App Widget's absolute minimum size. These values should specify
+ the size below which the App Widget would be illegible or otherwise unusable.
+ Using these attributes allows the user to resize the widget to a size that
+ may be smaller than the default widget size defined by the
+ minWidth and minHeight attributes.
+ Introduced in Android 3.1.
+
+ See the + App Widget Design Guidelines for more information on sizing your App + Widgets.
+updatePeriodMillis attribute defines how often the App
Widget framework should request an update from the {@link
android.appwidget.AppWidgetProvider} by calling the