Skip to content

Most visited

Recently visited

navigation
Added in API level 3

AppWidgetProviderInfo

public class AppWidgetProviderInfo
extends Object implements Parcelable

java.lang.Object
   ↳ android.appwidget.AppWidgetProviderInfo


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.

int WIDGET_CATEGORY_SEARCHBOX

Indicates that the widget can be displayed within a space reserved for the search box.

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

This field was deprecated in API level 21. Use loadLabel(android.content.pm.PackageManager).

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.

final UserHandle getProfile()

Gets the user profile in which the provider resides.

final Drawable loadIcon(Context context, int density)

Loads the icon to display for this AppWidget in the AppWidget picker.

final String loadLabel(PackageManager packageManager)

Loads the localized label to display to the user in the AppWidget picker.

final Drawable loadPreviewImage(Context context, int density)

Loads a preview of what the AppWidget will look like after it's configured.

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.

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Constants

RESIZE_BOTH

Added in API level 12
int RESIZE_BOTH

Widget is resizable in both the horizontal and vertical axes.

Constant Value: 3 (0x00000003)

RESIZE_HORIZONTAL

Added in API level 12
int RESIZE_HORIZONTAL

Widget is resizable in the horizontal axis only.

Constant Value: 1 (0x00000001)

RESIZE_NONE

Added in API level 12
int RESIZE_NONE

Widget is not resizable.

Constant Value: 0 (0x00000000)

RESIZE_VERTICAL

Added in API level 12
int RESIZE_VERTICAL

Widget is resizable in the vertical axis only.

Constant Value: 2 (0x00000002)

WIDGET_CATEGORY_HOME_SCREEN

Added in API level 17
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)

WIDGET_CATEGORY_KEYGUARD

Added in API level 17
int WIDGET_CATEGORY_KEYGUARD

Indicates that the widget can be displayed on the keyguard.

Constant Value: 2 (0x00000002)

WIDGET_CATEGORY_SEARCHBOX

Added in API level 21
int WIDGET_CATEGORY_SEARCHBOX

Indicates that the widget can be displayed within a space reserved for the search box.

Constant Value: 4 (0x00000004)

Fields

CREATOR

Added in API level 3
Creator<AppWidgetProviderInfo> CREATOR

Parcelable.Creator that instantiates AppWidgetProviderInfo objects

autoAdvanceViewId

Added in API level 11
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.

configure

Added in API level 3
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.

icon

Added in API level 3
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.

initialKeyguardLayout

Added in API level 17
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.

initialLayout

Added in API level 3
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.

label

Added in API level 3
String label

This field was deprecated in API level 21.
Use loadLabel(android.content.pm.PackageManager).

The label to display to the user in the AppWidget picker.

minHeight

Added in API level 3
int minHeight

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.

minResizeHeight

Added in API level 14
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.

minResizeWidth

Added in API level 14
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.

minWidth

Added in API level 3
int minWidth

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.

previewImage

Added in API level 11
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.

provider

Added in API level 3
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.

resizeMode

Added in API level 12
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.

updatePeriodMillis

Added in API level 3
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.

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

widgetCategory

Added in API level 17
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

AppWidgetProviderInfo

Added in API level 3
AppWidgetProviderInfo ()

AppWidgetProviderInfo

Added in API level 3
AppWidgetProviderInfo (Parcel in)

Unflatten the AppWidgetProviderInfo from a parcel.

Parameters
in Parcel

Public methods

clone

Added in API level 3
AppWidgetProviderInfo clone ()

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
AppWidgetProviderInfo a copy of this object.

describeContents

Added in API level 3
int describeContents ()

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

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

getProfile

Added in API level 21
UserHandle getProfile ()

Gets the user profile in which the provider resides.

Returns
UserHandle The hosting user profile.

loadIcon

Added in API level 21
Drawable loadIcon (Context context, 
                int density)

Loads the icon to display for this AppWidget in the AppWidget picker. If not supplied in the xml, the application icon will be used. A client can optionally provide a desired density such as DENSITY_LOW DENSITY_MEDIUM, etc. If no density is provided, the density of the current display will be used.

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

Parameters
context Context: Context for accessing resources.
density int: The optional desired density as per densityDpi.
Returns
Drawable The provider icon.

loadLabel

Added in API level 21
String loadLabel (PackageManager packageManager)

Loads the localized label to display to the user in the AppWidget picker.

Parameters
packageManager PackageManager: Package manager instance for loading resources.
Returns
String The label for the current locale.

loadPreviewImage

Added in API level 21
Drawable loadPreviewImage (Context context, 
                int density)

Loads a preview of what the AppWidget will look like after it's configured. A client can optionally provide a desired density such as DENSITY_LOW DENSITY_MEDIUM, etc. If no density is provided, the density of the current display will be used.

The loaded image corresponds to the android:previewImage attribute in the <receiver> element in the AndroidManifest.xml file.

Parameters
context Context: Context for accessing resources.
density int: The optional desired density as per densityDpi.
Returns
Drawable The widget preview image or null if preview image is not available.

toString

Added in API level 3
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 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
String a printable representation of this object.

writeToParcel

Added in API level 3
void writeToParcel (Parcel out, 
                int flags)

Flatten this object in to a Parcel.

Parameters
out Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.