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
Creator<AppWidgetProviderInfo> CREATOR Parcelable.Creator that instantiates AppWidgetProviderInfo objects
[Expand]
Inherited Constants
From interface android.os.Parcelable
Fields
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 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 Minimum height of the AppWidget, in dp.
public int minWidth Minimum width of the AppWidget, in dp.
public ComponentName provider Identity of this AppWidget component.
public int updatePeriodMillis How often, in milliseconds, that this AppWidget wants to be updated.
Public Constructors
AppWidgetProviderInfo()
AppWidgetProviderInfo(Parcel in)
Unflatten the AppWidgetProviderInfo from a parcel.
Public Methods
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 Creator<AppWidgetProviderInfo> CREATOR

Parcelable.Creator that instantiates AppWidgetProviderInfo objects

Fields

public ComponentName configure

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

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 initialLayout

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

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

Minimum height of the AppWidget, in dp.

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

public int minWidth

Minimum width of the AppWidget, in dp.

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

public ComponentName provider

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 updatePeriodMillis

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.

Public Constructors

public AppWidgetProviderInfo ()

public AppWidgetProviderInfo (Parcel in)

Unflatten the AppWidgetProviderInfo from a parcel.

Public Methods

public int describeContents ()

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 ()

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 simply concatenates the class name, the '@' sign and a hexadecimal representation of the object's hashCode(), that is, it is equivalent to the following expression: 

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

Returns
  • a printable representation of this object.

public void writeToParcel (Parcel out, int flags)

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.