PendingIntent クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
それに対して実行する意図アクションとターゲット アクションの説明。
[Android.Runtime.Register("android/app/PendingIntent", DoNotGenerateAcw=true)]
public sealed class PendingIntent : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/app/PendingIntent", DoNotGenerateAcw=true)>]
type PendingIntent = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 継承
- 属性
- 実装
注釈
それに対して実行する意図アクションとターゲット アクションの説明。 このクラスのインスタンスは、getActivity(Context, int, Intent, int), getActivities(Context, int, Intent, int), getBroadcast(Context, int, Intent, int), and getService(Context, int, Intent, int);返されたオブジェクトを他のアプリケーションに渡して、後でユーザーに代わって説明したアクションを実行できるようにします。 別のアプリケーションに PendingIntent を与えることで、他のアプリケーションが自分の操作であるかのように (同じアクセス許可と ID を持つ) 操作を実行する権限を付与することになります。 そのため、PendingIntent を構築する方法については注意する必要があります。たとえば、ほとんどの場合、指定する基本インテントには、コンポーネント名が独自のコンポーネントのいずれかに明示的に設定されている必要があります。最終的にそこに送信され、他の場所に送信されないようにする必要があります。 PendingIntent 自体は、取得に使用された元のデータを記述するシステムによって管理されるトークンへの参照にすぎません。 つまり、所有するアプリケーションのプロセスが強制終了された場合でも、PendingIntent 自体は、指定された他のプロセスから引き続き使用できます。 作成中のアプリケーションが後で同じ種類の PendingIntent (同じ操作、同じ意図アクション、データ、カテゴリ、コンポーネント、および同じフラグ) を再取得すると、同じトークンを表す PendingIntent がまだ有効な場合は受け取り、cancel() を呼び出して削除できます。 この動作のため、2 つの意図が PendingIntent を取得する目的で同じであると見なされるタイミングを把握することが重要です。 よくある間違いは、意図を持つ複数のPendingIntentオブジェクトを作成することです。これは、毎回異なるPendingIntentを取得することを期待して、その "余分な" コンテンツでのみ異なります。 これは発生しません。 一致に使用される意図の部分は、Intent.filterEquals で定義されたものと同じです。 Intent.filterEquals に従って同等の 2 つの Intent オブジェクトを使用すると、両方に同じPendingIntent が表示されます。 これに対処する一般的な方法は 2 つあります。 複数の個別のPendingIntent オブジェクトを同時にアクティブにする必要がある場合 (両方とも同時に表示される 2 つの通知として使用する場合など)、異なる PendingIntents に関連付けるには、それらのオブジェクトに異なる何かがあることを確認する必要があります。 これは、Intent.filterEquals によって考慮される Intent 属性、または getActivity(Context, int, Intent, int)、getActivities(Context, int, Intent, int)、getBroadcast(Context, int, Intent, int)、または getService(Context, int, Intent, int) に指定された異なる要求コード整数のいずれかです。 使用する意図に対してアクティブな PendingIntent が一度に 1 つだけ必要な場合は、フラグ FLAG_CANCEL_CURRENTまたはFLAG_UPDATE_CURRENTを使用して、指定する意図に関連付けられている現在の PendingIntent をキャンセルまたは変更することもできます。 また、FLAG_ONE_SHOTやFLAG_IMMUTABLEなどのフラグは、PendingIntent インスタンスを記述するため、それを識別するために使用されることに注意してください。 これらのフラグで作成された PendingIntent を取得または変更する呼び出しでは、これらのフラグを他のフラグと組み合わせて指定する必要もあります。 たとえば、FLAG_ONE_SHOTで作成された既存のPendingIntentを取得するには、FLAG_ONE_SHOTとFLAG_NO_CREATEの両方を指定する必要があります。
android.app.PendingIntentの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
フィールド
| 名前 | 説明 |
|---|---|
| FlagAllowUnsafeImplicitIntent |
古い.
FLAG_MUTABLEで作成された PendingIntent に、安全でない暗黙的な意図を含める許可があることを示すフラグ。 |
| FlagMutable |
古い.
作成されたPendingIntent を変更可能にする必要があることを示すフラグ。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Creator |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| CreatorPackage |
この PendingIntent を作成したアプリケーションのパッケージ名 (意図を実際に送信する ID) を返します。 |
| CreatorUid |
この PendingIntent を作成したアプリケーションの UID を返します。これは、意図を実際に送信する ID です。 |
| CreatorUserHandle |
この PendingIntent を作成したアプリケーションのユーザー ハンドル (意図を実際に送信するユーザー) を返します。 |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| IntentSender |
PendingIntent の既存の送信者をラップする IntentSender オブジェクトを取得します。 |
| IsActivity |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| IsBroadcast |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| IsForegroundService |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| IsImmutable |
この PendingIntent が FLAG_IMMUTABLE でマークされているかどうかを確認します。 |
| IsService |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| JniPeerMembers |
Android.App.PendingIntent 用の JNI バインディング インフラストラクチャを提供します。 |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| TargetPackage |
古い.
このメソッドは、API レベル 17 では非推奨になりました。 |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
メソッド
| 名前 | 説明 |
|---|---|
| Cancel() |
現在アクティブなPendingIntent を取り消します。 |
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| DescribeContents() |
この Parcelable インスタンスのマーシャリングされた表現に含まれる特殊なオブジェクトの種類について説明します。 |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| Equals(Object) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle) |
getActivity(Context,int,Intent,int) と同様ですが、インテントの配列を指定できます。 |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags) |
getActivity(Context,int,Intent,int) と同様ですが、インテントの配列を指定できます。 |
| GetActivity(Context, Int32, Intent, PendingIntentFlags, Bundle) |
Context.startActivity(Intent) の呼び出しなど、新しいアクティビティを開始する PendingIntent を取得します。 |
| GetActivity(Context, Int32, Intent, PendingIntentFlags) |
Context.startActivity(Intent) の呼び出しなど、新しいアクティビティを開始する PendingIntent を取得します。 |
| GetBroadcast(Context, Int32, Intent, PendingIntentFlags) |
Context.sendBroadcast() の呼び出しなど、ブロードキャストを実行する PendingIntent を取得します。 |
| GetForegroundService(Context, Int32, Intent, PendingIntentFlags) |
Context.startForegroundService() の呼び出しなど、フォアグラウンド サービスを開始する PendingIntent を取得します。 |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| GetService(Context, Int32, Intent, PendingIntentFlags) |
Context.startService() の呼び出しなど、サービスを開始する PendingIntent を取得します。 |
| JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| ReadPendingIntentOrNullFromParcel(Parcel) |
パーセルから PendingIntent または null ポインターを読み取るための便利な関数。 |
| Send() |
この PendingIntent に関連付けられている操作を実行します。 |
| Send(Bundle) |
この PendingIntent に関連付けられている操作を実行し、操作の追加オプションを指定します。 |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String, Bundle) |
この PendingIntent に関連付けられている操作を実行します。これにより、呼び出し元は、使用する意図に関する情報を指定し、送信が完了したときに通知を受け取ることができます。 |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String) |
この PendingIntent に関連付けられている操作を実行します。これにより、呼び出し元は、使用する意図に関する情報を指定し、送信が完了したときに通知を受け取ることができます。 |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler) |
この PendingIntent に関連付けられている操作を実行します。これにより、呼び出し元は、使用する意図に関する情報を指定し、送信が完了したときに通知を受け取ることができます。 |
| Send(Context, Result, Intent) |
この PendingIntent に関連付けられている操作を実行して、呼び出し元が使用する意図に関する情報を指定できるようにします。 |
| Send(Result, PendingIntent+IOnFinished, Handler) |
この PendingIntent に関連付けられている操作を実行して、送信が完了したときに呼び出し元に通知できるようにします。 |
| Send(Result) |
この PendingIntent に関連付けられている操作を実行します。 |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| ToArray<T>() |
このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object) |
| Wait() |
現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| WritePendingIntentOrNullToParcel(PendingIntent, Parcel) |
PendingIntent または null ポインターをパーセルに書き込むための便利な関数。 |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
このオブジェクトをパーセルにフラット化します。 |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IJavaPeerable.Disposed() |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.Finalized() |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
それに対して実行する意図アクションとターゲット アクションの説明。 (継承元 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
それに対して実行する意図アクションとターゲット アクションの説明。 |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
それに対して実行する意図アクションとターゲット アクションの説明。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|