Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

AppWidgetProviderInfo

extends Object
implements Parcelable
java.lang.Object
   ↳ android.appwidget.AppWidgetProviderInfo

Class Overview

Describes the meta data for an installed AppWidget provider. The fields in this class correspond to the fields in the <appwidget-provider> xml tag.

Summary

Constants
int RESIZE_BOTH Widget is resizable in both the horizontal and vertical axes.
int RESIZE_HORIZONTAL Widget is resizable in the horizontal axis only.
int RESIZE_NONE Widget is not resizable.
int RESIZE_VERTICAL Widget is resizable in the vertical axis only.
int WIDGET_CATEGORY_HOME_SCREEN Indicates that the widget can be displayed on the home screen.
int WIDGET_CATEGORY_KEYGUARD Indicates that the widget can be displayed on the keyguard.
[Expand]
Inherited Constants
From interface android.os.Parcelable
Fields
public static final Creator < AppWidgetProviderInfo > CREATOR Parcelable.Creator that instantiates AppWidgetProviderInfo objects
public int autoAdvanceViewId The view id of the AppWidget subview which should be auto-advanced by the widget's host.
public ComponentName configure The activity to launch that will configure the AppWidget.
public int icon The icon to display for this AppWidget in the AppWidget picker.
public int initialKeyguardLayout The resource id of the initial layout for this AppWidget when it is displayed on keyguard.
public int initialLayout The resource id of the initial layout for this AppWidget.
public String label The label to display to the user in the AppWidget picker.
public int minHeight The default height of the widget when added to a host, in dp.
public int minResizeHeight Minimum height (in dp) which the widget can be resized to.
public int minResizeWidth Minimum width (in dp) which the widget can be resized to.
public int minWidth The default height of the widget when added to a host, in dp.
public int previewImage A preview of what the AppWidget will look like after it's configured.
public ComponentName provider Identity of this AppWidget component.
public int resizeMode The rules by which a widget can be resized.
public int updatePeriodMillis How often, in milliseconds, that this AppWidget wants to be updated.
public int widgetCategory Determines whether this widget can be displayed on the home screen, the keyguard, or both.
Public Constructors
AppWidgetProviderInfo ()
AppWidgetProviderInfo ( Parcel in)
Unflatten the AppWidgetProviderInfo from a parcel.
Public Methods
AppWidgetProviderInfo clone ()
Creates and returns a copy of this Object .
int describeContents ()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
String toString ()
Returns a string containing a concise, human-readable description of this object.
void writeToParcel ( Parcel out, int flags)
Flatten this object in to a Parcel.
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Constants

public static final int RESIZE_BOTH

Widget is resizable in both the horizontal and vertical axes.

Constant Value: 3 (0x00000003)

public static final int RESIZE_HORIZONTAL

Widget is resizable in the horizontal axis only.

Constant Value: 1 (0x00000001)

public static final int RESIZE_NONE

Widget is not resizable.

Constant Value: 0 (0x00000000)

public static final int RESIZE_VERTICAL

Widget is resizable in the vertical axis only.

Constant Value: 2 (0x00000002)

public static final int WIDGET_CATEGORY_HOME_SCREEN

Indicates that the widget can be displayed on the home screen. This is the default value.

Constant Value: 1 (0x00000001)

public static final int WIDGET_CATEGORY_KEYGUARD

Indicates that the widget can be displayed on the keyguard.

Constant Value: 2 (0x00000002)

Fields

public static final Creator < AppWidgetProviderInfo > CREATOR

Added in API level 3

Parcelable.Creator that instantiates AppWidgetProviderInfo objects

public int autoAdvanceViewId

The view id of the AppWidget subview which should be auto-advanced by the widget's host.

This field corresponds to the android:autoAdvanceViewId attribute in the AppWidget meta-data file.

public ComponentName configure

Added in API level 3

The activity to launch that will configure the AppWidget.

This class name of field corresponds to the android:configure attribute in the AppWidget meta-data file. The package name always corresponds to the package containing the AppWidget provider.

public int icon

Added in API level 3

The icon to display for this AppWidget in the AppWidget picker. If not supplied in the xml, the application icon will be used.

This field corresponds to the android:icon attribute in the <receiver> element in the AndroidManifest.xml file.

public int initialKeyguardLayout

The resource id of the initial layout for this AppWidget when it is displayed on keyguard. This parameter only needs to be provided if the widget can be displayed on the keyguard, see widgetCategory .

This field corresponds to the android:initialKeyguardLayout attribute in the AppWidget meta-data file.

public int initialLayout

Added in API level 3

The resource id of the initial layout for this AppWidget. This should be displayed until the RemoteViews for the AppWidget is available.

This field corresponds to the android:initialLayout attribute in the AppWidget meta-data file.

public String label

Added in API level 3

The label to display to the user in the AppWidget picker. If not supplied in the xml, the application label will be used.

This field corresponds to the android:label attribute in the <receiver> element in the AndroidManifest.xml file.

public int minHeight

Added in API level 3

The default height of the widget when added to a host, in dp. The widget will get at least this height, and will often be given more, depending on the host.

This field corresponds to the android:minHeight attribute in the AppWidget meta-data file.

public int minResizeHeight

Minimum height (in dp) which the widget can be resized to. This field has no effect if it is greater than minHeight or if vertical resizing isn't enabled (see resizeMode ).

This field corresponds to the android:minResizeHeight attribute in the AppWidget meta-data file.

public int minResizeWidth

Minimum width (in dp) which the widget can be resized to. This field has no effect if it is greater than minWidth or if horizontal resizing isn't enabled (see resizeMode ).

This field corresponds to the android:minResizeWidth attribute in the AppWidget meta-data file.

public int minWidth

Added in API level 3

The default height of the widget when added to a host, in dp. The widget will get at least this width, and will often be given more, depending on the host.

This field corresponds to the android:minWidth attribute in the AppWidget meta-data file.

public int previewImage

A preview of what the AppWidget will look like after it's configured. If not supplied, the AppWidget's icon will be used.

This field corresponds to the android:previewImage attribute in the <receiver> element in the AndroidManifest.xml file.

public ComponentName provider

Added in API level 3

Identity of this AppWidget component. This component should be a BroadcastReceiver , and it will be sent the AppWidget intents as described in the AppWidget package documentation .

This field corresponds to the android:name attribute in the <receiver> element in the AndroidManifest.xml file.

public int resizeMode

The rules by which a widget can be resized. See RESIZE_NONE , RESIZE_NONE , RESIZE_HORIZONTAL , RESIZE_VERTICAL , RESIZE_BOTH .

This field corresponds to the android:resizeMode attribute in the AppWidget meta-data file.

public int updatePeriodMillis

Added in API level 3

How often, in milliseconds, that this AppWidget wants to be updated. The AppWidget manager may place a limit on how often a AppWidget is updated.

This field corresponds to the android:updatePeriodMillis attribute in the AppWidget meta-data file.

Note: Updates requested with updatePeriodMillis will not be delivered more than once every 30 minutes.

public int widgetCategory

Determines whether this widget can be displayed on the home screen, the keyguard, or both. A widget which is displayed on both needs to ensure that it follows the design guidelines for both widget classes. This can be achieved by querying the AppWidget options in its widget provider's update method.

This field corresponds to the widgetCategory attribute in the AppWidget meta-data file.

Public Constructors

public AppWidgetProviderInfo ()

Added in API level 3

public AppWidgetProviderInfo ( Parcel in)

Added in API level 3

Unflatten the AppWidgetProviderInfo from a parcel.

Public Methods

public AppWidgetProviderInfo clone ()

Added in API level 3

Creates and returns a copy of this Object . The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should call super.clone() to create the new instance and then create deep copies of the nested, mutable objects.

Returns
  • a copy of this object.

public int describeContents ()

Added in API level 3

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Returns
  • a bitmask indicating the set of special object types marshalled by the Parcelable.

public String toString ()

Added in API level 3

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

          getClass().getName() + '@' + Integer.toHexString(hashCode())
         

See Writing a useful toString method if you intend implementing your own toString method.

Returns
  • a printable representation of this object.

public void writeToParcel ( Parcel out, int flags)

Added in API level 3

Flatten this object in to a Parcel.

Parameters
out The Parcel in which the object should be written.
flags Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE .