Share via


AppWidgetManager Class

Definition

Updates AppWidget state; gets information about installed AppWidget providers and other AppWidget related state.

[Android.Runtime.Register("android/appwidget/AppWidgetManager", DoNotGenerateAcw=true)]
public class AppWidgetManager : Java.Lang.Object
[<Android.Runtime.Register("android/appwidget/AppWidgetManager", DoNotGenerateAcw=true)>]
type AppWidgetManager = class
    inherit Object
Inheritance
AppWidgetManager
Attributes

Remarks

Updates AppWidget state; gets information about installed AppWidget providers and other AppWidget related state.

<div class="special reference"> <h3>Developer Guides</h3>

For more information about creating app widgets, read the App Widgets developer guide.

</div>

Java documentation for android.appwidget.AppWidgetManager.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

AppWidgetManager(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

Fields

ActionAppwidgetBind

Activity action to launch from your AppWidgetHost activity when you want to bind an AppWidget to display and bindAppWidgetIdIfAllowed returns false.

ActionAppwidgetConfigure

Sent when it is time to configure your AppWidget while it is being added to a host.

ActionAppwidgetDeleted

Sent when an instance of an AppWidget is deleted from its host.

ActionAppwidgetDisabled

Sent when the last AppWidget of this provider is removed from the last host.

ActionAppwidgetEnabled

Sent when an instance of an AppWidget is added to a host for the first time.

ActionAppwidgetHostRestored

Sent to widget hosts after AppWidget state related to the host has been restored from backup.

ActionAppwidgetOptionsChanged

Sent when the custom extras for an AppWidget change.

ActionAppwidgetPick

Activity action to launch from your AppWidgetHost activity when you want to pick an AppWidget to display.

ActionAppwidgetRestored

Sent to an AppWidgetProvider after AppWidget state related to that provider has been restored from backup.

ActionAppwidgetUpdate

Sent when it is time to update your AppWidget.

ExtraAppwidgetId

An intent extra (int) that contains one appWidgetId.

ExtraAppwidgetIds

An intent extra that contains multiple appWidgetIds.

ExtraAppwidgetOldIds

An intent extra that contains multiple appWidgetIds.

ExtraAppwidgetOptions

An intent extra which points to a bundle of extra information for a particular widget id.

ExtraAppwidgetPreview

An extra that can be passed to #requestPinAppWidget(ComponentName, Bundle, PendingIntent).

ExtraAppwidgetProvider

An intent extra that contains the component name of a AppWidget provider.

ExtraAppwidgetProviderProfile

An intent extra that contains the user handle of the profile under which an AppWidget provider is registered.

ExtraCustomExtras

An intent extra to pass to the AppWidget picker containing a java.util.List of android.os.Bundle objects to mix in to the list of AppWidgets that are installed.

ExtraCustomInfo

An intent extra to pass to the AppWidget picker containing a java.util.List of AppWidgetProviderInfo objects to mix in to the list of AppWidgets that are installed.

ExtraHostId

An intent extra attached to the #ACTION_APPWIDGET_HOST_RESTORED broadcast, indicating the integer ID of the host whose widgets have just been restored.

InvalidAppwidgetId

A sentinel value that the AppWidget manager will never return as a appWidgetId.

MetaDataAppwidgetProvider

Field for the manifest meta-data tag.

OptionAppwidgetHostCategory

A bundle extra that hints to the AppWidgetProvider the category of host that owns this this widget.

OptionAppwidgetMaxHeight

A bundle extra (int) that contains the upper bound on the current width, in dips, of a widget instance.

OptionAppwidgetMaxWidth

A bundle extra (int) that contains the upper bound on the current width, in dips, of a widget instance.

OptionAppwidgetMinHeight

A bundle extra (int) that contains the lower bound on the current height, in dips, of a widget instance.

OptionAppwidgetMinWidth

A bundle extra (int) that contains the lower bound on the current width, in dips, of a widget instance.

OptionAppwidgetRestoreCompleted

A bundle extra (boolean) that contains whether or not an app has finished restoring a widget.

OptionAppwidgetSizes

A bundle extra (List<SizeF>) that contains the list of possible sizes, in dips, a widget instance can take.

Properties

Class

Returns the runtime class of this Object.

(Inherited from Object)
Handle

The handle to the underlying Android instance.

(Inherited from Object)
InstalledProviders

Return a list of the AppWidget providers that are currently installed.

IsRequestPinAppWidgetSupported

Return TRUE if the default launcher supports #requestPinAppWidget(ComponentName, Bundle, PendingIntent)

JniIdentityHashCode (Inherited from Object)
JniPeerMembers
PeerReference (Inherited from Object)
ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

Methods

BindAppWidgetId(Int32, ComponentName)

Set the component for a given appWidgetId.

BindAppWidgetIdIfAllowed(Int32, ComponentName, Bundle)

Set the component for a given appWidgetId.

BindAppWidgetIdIfAllowed(Int32, ComponentName)

Set the component for a given appWidgetId.

BindAppWidgetIdIfAllowed(Int32, UserHandle, ComponentName, Bundle)

Set the provider for a given appWidgetId if the caller has a permission.

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
GetAppWidgetIds(ComponentName)

Get the list of appWidgetIds that have been bound to the given AppWidget provider.

GetAppWidgetInfo(Int32)

Get the available info about the AppWidget.

GetAppWidgetOptions(Int32)

Get the extras associated with a given widget instance.

GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
GetInstalledProvidersForPackage(String, UserHandle)

Gets the AppWidget providers for the given package and user profile.

GetInstalledProvidersForProfile(UserHandle)

Gets the AppWidget providers for the given user profile.

GetInstance(Context)

Get the AppWidgetManager instance to use for the supplied android.content.Context Context object.

JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
NotifyAppWidgetViewDataChanged(Int32, Int32)

Notifies the specified collection view in the specified AppWidget instance to invalidate its data.

NotifyAppWidgetViewDataChanged(Int32[], Int32)

Notifies the specified collection view in all the specified AppWidget instances to invalidate their data.

PartiallyUpdateAppWidget(Int32, RemoteViews)

Perform an incremental update or command on the widget specified by appWidgetId.

PartiallyUpdateAppWidget(Int32[], RemoteViews)

Perform an incremental update or command on the widget(s) specified by appWidgetIds.

RequestPinAppWidget(ComponentName, Bundle, PendingIntent)

Request to pin an app widget on the current launcher.

SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
UpdateAppWidget(ComponentName, RemoteViews)

Set the RemoteViews to use for all AppWidget instances for the supplied AppWidget provider.

UpdateAppWidget(Int32, RemoteViews)

Set the RemoteViews to use for the specified appWidgetId.

UpdateAppWidget(Int32[], RemoteViews)

Set the RemoteViews to use for the specified appWidgetIds.

UpdateAppWidgetOptions(Int32, Bundle)

Update the extras for a given widget instance.

UpdateAppWidgetProviderInfo(ComponentName, String)

Updates the info for the supplied AppWidget provider.

Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to