AppWidgetManager Class

Reference

Definition

Namespace:: Android.Appwidget

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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: Object

Object
AppWidgetManager

Attributes: RegisterAttribute

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)	Set the component for a given appWidgetId.
BindAppWidgetIdIfAllowed(Int32, ComponentName, Bundle)	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)	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, 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)

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