AppWidgetManager.RequestPinAppWidget Método

Definição

Namespace:: Android.Appwidget

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Solicite fixar um widget de aplicativo no inicializador atual.

[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

O ComponentName para o android.content.BroadcastReceiver BroadcastReceiver provedor para seu AppWidget.

extras: Bundle

Se não for nulo, isso será passado para o aplicativo inicializador. Por exemplo, #EXTRA_APPWIDGET_PREVIEW pode ser usado para uma visualização personalizada.

successCallback: PendingIntent

Se não for nulo, essa intenção será enviada quando o widget for criado.

Retornos

Boolean

true se o inicializador der suporte a esse recurso. Observe que a API retornará sem esperar que o usuário responda, portanto, obter true dessa API não significa que o atalho está fixado. false se o inicializador não der suporte a esse recurso ou se o aplicativo de chamada pertencer a um perfil de usuário com itens restritos na tela inicial. Se o Bloqueio de Aplicativo estiver habilitado para o aplicativo de chamada, esse método falhará e retornará false.

Atributos: RegisterAttribute

Comentários

Solicite fixar um widget de aplicativo no inicializador atual. Cabe ao inicializador aceitar essa solicitação (opcionalmente mostrando uma confirmação do usuário). Se a solicitação for aceita, o chamador receberá uma confirmação com extra #EXTRA_APPWIDGET_ID.

Quando uma solicitação é negada pelo usuário, o aplicativo chamador não receberá nenhuma resposta.

Somente aplicativos com uma atividade em primeiro plano ou um serviço em primeiro plano podem chamá-lo. Caso contrário, ele lançará IllegalStateException.

Cabe ao inicializador como lidar com solicitações pendentes anteriores quando o mesmo pacote chama essa API várias vezes em uma linha. Ele pode ignorar as solicitações anteriores, por exemplo.

O Inicializador não mostrará a atividade de configuração associada ao provedor nesse caso. O aplicativo pode mostrar a atividade de configuração como uma resposta ao retorno de chamada ou mostrar se antes de chamar a API (várias configurações podem ser encapsuladas successCallback para evitar persisti-las antes que o widgetId seja conhecido).

Java documentação para android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a