AppWidgetManager.RequestPinAppWidget 方法

定义

命名空间:: Android.Appwidget

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

请求在当前启动器上固定应用小组件。

[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

参数

provider: ComponentName

ComponentName android.content.BroadcastReceiver BroadcastReceiver AppWidget 的提供程序。

extras: Bundle

如果不是 null，则会将此传递给启动器应用。例如 #EXTRA_APPWIDGET_PREVIEW ，可用于自定义预览。

successCallback: PendingIntent

如果未为 null，将在创建小组件时发送此意向。

Boolean

如果启动器支持此功能，则为。请注意，API 将返回而不等待用户响应，因此从此 API 获取TRUE并不意味着快捷方式已固定。 FALSE 如果启动器不支持此功能，或者调用应用属于用户配置文件，且主屏幕上限制的项目。

属性: RegisterAttribute

注解

请求在当前启动器上固定应用小组件。由启动器来接受此请求（可选）显示用户确认。如果接受请求，调用方将收到额外 #EXTRA_APPWIDGET_ID确认。

当用户拒绝请求时，调用方应用将不会收到任何响应。

只有具有前台活动或前台服务的应用才能调用它。否则将引发 IllegalStateException。

当同一包在一行中多次调用此 API 时，启动器可以如何处理以前的挂起请求。例如，它可能会忽略以前的请求。

在这种情况下，启动器不会显示与提供程序关联的配置活动。应用可以将配置活动显示为对回调的响应，或者在调用 API 之前显示（可以封装 successCallback 各种配置以避免在 widgetId 已知之前保留它们）。

Java文档android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent)。

本页的某些部分是根据创建和共享的工作进行的修改，并根据许可证中所述的条款使用。

适用于