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

TRUE 시작 관리자가 이 기능을 지원하는 경우 API는 사용자가 응답할 때까지 기다리지 않고 반환되므로 이 API에서 가져오는 TRUE 것이 바로 가기가 고정된 것은 아닙니다 . FALSE 시작 관리자가 이 기능을 지원하지 않거나 호출 앱이 홈 화면에서 제한된 항목이 있는 사용자 프로필에 속하는 경우

특성: RegisterAttribute

설명

현재 시작 관리자에 앱 위젯을 고정하도록 요청합니다. 이 요청을 수락하는 것은 시작 관리자에게 달려 있습니다(선택적으로 사용자 확인 표시). 요청이 수락되면 호출자는 추가 #EXTRA_APPWIDGET_ID확인을 받습니다.

사용자가 요청을 거부하면 호출자 앱은 응답을 받지 않습니다.

포그라운드 활동 또는 포그라운드 서비스가 있는 앱만 호출할 수 있습니다. 그렇지 않으면 throw IllegalStateException됩니다.

동일한 패키지가 이 API를 여러 번 연속으로 호출할 때 보류 중인 이전 요청을 처리하는 방법은 시작 관리자의 맡입니다. 예를 들어 이전 요청을 무시할 수 있습니다.

이 경우 시작 관리자에 공급자와 연결된 구성 작업이 표시되지 않습니다. 앱은 구성 활동을 콜백에 대한 응답으로 표시하거나 API를 호출하기 전에 표시할 수 있습니다(위젯Id가 알려지기 전에 유지되지 않도록 다양한 구성을 캡슐화 successCallback 할 수 있음).

에 대한 android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent)Java 설명서

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.

적용 대상