AppWidgetManager.RequestPinAppWidget Método

Definición

Espacio de nombres:: Android.Appwidget

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Solicite anclar un widget de aplicación en el iniciador actual.

[Android.Runtime.Register("requestPinAppWidget", "(Landroid/content/ComponentName;Landroid/os/Bundle;Landroid/app/PendingIntent;)Z", "GetRequestPinAppWidget_Landroid_content_ComponentName_Landroid_os_Bundle_Landroid_app_PendingIntent_Handler", ApiSince=26)]
public virtual bool RequestPinAppWidget(Android.Content.ComponentName provider, Android.OS.Bundle? extras, Android.App.PendingIntent? successCallback);

[<Android.Runtime.Register("requestPinAppWidget", "(Landroid/content/ComponentName;Landroid/os/Bundle;Landroid/app/PendingIntent;)Z", "GetRequestPinAppWidget_Landroid_content_ComponentName_Landroid_os_Bundle_Landroid_app_PendingIntent_Handler", ApiSince=26)>]
abstract member RequestPinAppWidget : Android.Content.ComponentName * Android.OS.Bundle * Android.App.PendingIntent -> bool
override this.RequestPinAppWidget : Android.Content.ComponentName * Android.OS.Bundle * Android.App.PendingIntent -> bool

Parámetros

provider: ComponentName

ComponentName para el android.content.BroadcastReceiver BroadcastReceiver proveedor de AppWidget.

extras: Bundle

SI no es NULL, se pasa a la aplicación del iniciador. Por ejemplo, #EXTRA_APPWIDGET_PREVIEW se puede usar para una vista previa personalizada.

successCallback: PendingIntent

Si no es null, esta intención se enviará cuando se cree el widget.

Devoluciones

Boolean

TRUE si el iniciador admite esta característica. Tenga en cuenta que la API devolverá sin esperar a que el usuario responda, por lo que obtener TRUE de esta API no significa que el acceso directo esté anclado. FALSE si el iniciador no admite esta característica o si la aplicación de llamada pertenece a un perfil de usuario con elementos restringidos en la pantalla principal.

Atributos: RegisterAttribute

Comentarios

Solicite anclar un widget de aplicación en el iniciador actual. Es necesario que el iniciador acepte esta solicitud (opcionalmente, mostrando una confirmación del usuario). Si se acepta la solicitud, el autor de la llamada recibirá una confirmación con más #EXTRA_APPWIDGET_ID.

Cuando el usuario deniega una solicitud, la aplicación de llamada no recibirá ninguna respuesta.

Solo las aplicaciones con una actividad en primer plano o un servicio en primer plano pueden llamarla. De lo contrario, iniciará IllegalStateException.

Es necesario que el iniciador controle las solicitudes pendientes anteriores cuando el mismo paquete llama a esta API varias veces en una fila. Por ejemplo, puede omitir las solicitudes anteriores.

El iniciador no mostrará la actividad de configuración asociada al proveedor en este caso. La aplicación podría mostrar la actividad de configuración como respuesta a la devolución de llamada o mostrar si antes de llamar a la API (se pueden encapsular varias configuraciones para successCallback evitar conservarlas antes de que se conozca el widgetId).

Java documentación para android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a