ShortcutManager.RequestPinShortcut(ShortcutInfo, IntentSender) メソッド

定義

名前空間:

Android.Content.PM

アセンブリ:

Mono.Android.dll

ピン留めされたショートカットの作成を要求します。

[Android.Runtime.Register("requestPinShortcut", "(Landroid/content/pm/ShortcutInfo;Landroid/content/IntentSender;)Z", "GetRequestPinShortcut_Landroid_content_pm_ShortcutInfo_Landroid_content_IntentSender_Handler", ApiSince=26)]
public virtual bool RequestPinShortcut (Android.Content.PM.ShortcutInfo shortcut, Android.Content.IntentSender? resultIntent);

[<Android.Runtime.Register("requestPinShortcut", "(Landroid/content/pm/ShortcutInfo;Landroid/content/IntentSender;)Z", "GetRequestPinShortcut_Landroid_content_pm_ShortcutInfo_Landroid_content_IntentSender_Handler", ApiSince=26)>]
abstract member RequestPinShortcut : Android.Content.PM.ShortcutInfo * Android.Content.IntentSender -> bool
override this.RequestPinShortcut : Android.Content.PM.ShortcutInfo * Android.Content.IntentSender -> bool

パラメーター

shortcut

ShortcutInfo

ピン留めするショートカット。 アプリが既存の (静的または動的な) ショートカットをピン留めする場合は、ID のみが必要です。 他のフィールドを設定する必要はありませんが、ターゲット ショートカットを有効にする必要があります。

            <p>If it's a new shortcut, all the mandatory fields, such as a short label, must be
            set.

resultIntent

IntentSender

null でない場合、この意図はショートカットがピン留めされたときに送信されます。 を使用して android.app.PendingIntent#getIntentSender() を作成します IntentSender。 バックグラウンド実行の制限を回避するには、エクスポートされていないマニフェストで宣言されたレシーバーを使用します。 詳細については、次を参照してください。

           Creating pinned shortcuts.

戻り値

Boolean

TRUE ランチャーがこの機能をサポートしている場合は 。 ユーザーが応答するのを待たずに API が返されることに注意してください。そのため、この API から取得 TRUE しても、ショートカットが正常にピン留めされた わけではありません 。 FALSE ランチャーがこの機能をサポートしていない場合は 。

属性

RegisterAttribute

注釈

ピン留めされたショートカットの作成を要求します。 既定のランチャーはこの要求を受け取り、ユーザーに承認を求めます。 ユーザーが承認すると、ショートカットが作成され resultIntent 、送信されます。 ただし、要求がユーザーによって拒否された場合、呼び出し元に応答は送信されません。

フォアグラウンド アクティビティまたはフォアグラウンド サービスを持つアプリのみが、このメソッドを呼び出すことができます。 それ以外の場合は、 がスロー IllegalStateExceptionされます。

同じパッケージがこの API を複数回連続して呼び出すときに、以前の保留中の要求を処理する方法を決定するのはランチャー次第です。 考えられる方法の 1 つは、以前の要求を無視することです。

<b>注:</b> サポート ライブラリの対応androidx.core.content.pm.ShortcutManagerCompat#requestPinShortcut( Context, ShortcutInfoCompat, IntentSender)する も参照してください。これは、従来のプライベート 意図 com.android.launcher.action.INSTALL_SHORTCUTを使用するよりもVERSION_CODES#O低い Android バージョンをサポートしています。

の Java ドキュメント android.content.pm.ShortcutManager.requestPinShortcut(android.content.pm.ShortcutInfo, android.content.IntentSender)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。