99久久婷婷国产综合精品草原,久久精品无码一区二区无码,久久久久综合国产欧美一区二区

PendingIntent詳解（轉(zhuǎn)載）

PendingIntent詳解

http://hubingforever.blog.163.com/blog/static/17104057920117275222472/

2011-08-05 10:13:04| 分類： Android基礎(chǔ) | 標(biāo)簽：pendingintent |字號訂閱

本文翻譯整理自：http://developer.android.com/reference/android/app/PendingIntent.html

public final class

PendingIntent

extends Object

implements Parcelable

簡介

PendingIntent用于描述Intent及其最終的行為.

你可以通過getActivity(Context context, int requestCode, Intent intent, int flags)系列方法從系統(tǒng)取得一個用于啟動一個Activity的PendingIntent對象,

可以通過getService(Context context, int requestCode, Intent intent, int flags)方法從系統(tǒng)取得一個用于啟動一個Service的PendingIntent對象

可以通過getBroadcast(Context context, int requestCode, Intent intent, int flags)方法從系統(tǒng)取得一個用于向BroadcastReceiver的Intent廣播的PendingIntent對象

返回的PendingIntent可以遞交給別的應(yīng)用程序，然后繼續(xù)處理。這里的話你可以稍后才處理PendingIntent中描述的Intent及其最終行為。

當(dāng)你把PendingIntent遞交給別的程序進(jìn)行處理時,PendingIntent仍然擁有PendingIntent原程序所擁有的權(quán)限(with the same permissions and identity).當(dāng)你從系統(tǒng)取得一個PendingIntent時，一定要非常小心才行。比如，通常，如果Intent目的地是你自己的component（Activity/Service/BroadcastReceiver）的話，你最好采用在Intent中顯示指定目的component名字的方式，以確保Intent最終能發(fā)到目的，否則Intent最后可能不知道發(fā)到哪里了。一個PendingIntent就是Android系統(tǒng)中的一個token（節(jié)點，這個應(yīng)該是Linux或C\C++用語）的一個對象引用，它描述了一些將用于retrieve的數(shù)據(jù)（這里，這些數(shù)據(jù)描述了Intent及其最終的行為）。

這就意味著即使PendingIntent原進(jìn)程結(jié)束了的話, PendingIntent本身仍然還存在，可在其他進(jìn)程（PendingIntent被遞交到的其他程序）中繼續(xù)使用.如果我在從系統(tǒng)中提取一個PendingIntent的，而系統(tǒng)中有一個和你描述的PendingIntent對等的PendingInent, 那么系統(tǒng)會直接返回和該PendingIntent其實是同一token的PendingIntent，而不是一個新的token和PendingIntent。然而你在從提取PendingIntent時，通過FLAG_CANCEL_CURRENT參數(shù)，讓這個老PendingIntent的先cancel()掉，這樣得到的pendingInten和其token的就是新的了。

通過FLAG_UPDATE_CURRENT參數(shù)的話，可以讓新的Intent會更新之前PendingIntent中的Intent對象數(shù)據(jù)，例如更新Intent中的Extras。另外，我們也可以在PendingIntent的原進(jìn)程中調(diào)用PendingIntent的cancel ()把其從系統(tǒng)中移除掉。

注意：兩個PendingIntent對等是指它們的operation一樣, 且其它們的Intent的action, data, categories, components和flags都一樣。但是它們的Intent的Extra可以不一樣。

主要常量

FLAG_CANCEL_CURRENT:如果當(dāng)前系統(tǒng)中已經(jīng)存在一個相同的PendingIntent對象，那么就將先將已有的PendingIntent取消，然后重新生成一個PendingIntent對象。

FLAG_NO_CREATE:如果當(dāng)前系統(tǒng)中不存在相同的PendingIntent對象，系統(tǒng)將不會創(chuàng)建該PendingIntent對象而是直接返回null。

FLAG_ONE_SHOT:該PendingIntent只作用一次。在該PendingIntent對象通過send()方法觸發(fā)過后，PendingIntent將自動調(diào)用cancel()進(jìn)行銷毀，那么如果你再調(diào)用send()方法的話，系統(tǒng)將會返回一個SendIntentException。

FLAG_UPDATE_CURRENT:如果系統(tǒng)中有一個和你描述的PendingIntent對等的PendingInent，那么系統(tǒng)將使用該PendingIntent對象，但是會使用新的Intent來更新之前PendingIntent中的Intent對象數(shù)據(jù)，例如更新Intent中的Extras。

主要成員函數(shù)

getActivities系列方法

該系列方法將從系統(tǒng)取得一個用于啟動一個Activity的PendingIntent對象。

public static PendingIntent getActivity (Context context, int requestCode, Intent intent, int flags)

Since: API Level 1

Retrieve a PendingIntent that will start a new activity, like calling Context.startActivity(Intent). Note that the activity will be started outside of the context of an existing activity, so you must use the Intent.FLAG_ACTIVITY_NEW_TASK launch flag in the Intent.

因為對于Context的startActivity方法，如果不是在其子類（Activity）中調(diào)用，那么必須對Intent加上FLAG_ACTIVITY_NEW_TASK。

具體可以參照Context中對startActivity方法的說明或《Activity和Task的基本模型》

Parameters

context	The Context in which this PendingIntent should start the activity.
requestCode	Private request code for the sender (currently not used).
intent	Intent of the activity to be launched.
flags	May be `FLAG_ONE_SHOT`, `FLAG_NO_CREATE`, `FLAG_CANCEL_CURRENT`, `FLAG_UPDATE_CURRENT`, or any of the flags as supported by`Intent.fillIn()` to control which unspecified parts of the intent that can be supplied when the actual send happens. 當(dāng)我們使用Intent.fillIn()方法時，表示其Intent的某個數(shù)據(jù)項可以被send方法的Inent參數(shù)進(jìn)行覆蓋重寫。

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if FLAG_NO_CREATE has been supplied.

public static PendingIntent getActivities (Context context, int requestCode, Intent[] intents, int flags)

Since: API Level 11

Like getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied. The first Intent in the array is taken as the primary key for the PendingIntent, like the single Intent given to getActivity(Context, int, Intent, int). Upon sending the resulting PendingIntent, all of the Intents are started in the same way as they would be by passing them to startActivities(Intent[]).

The first intent in the array will be started outside of the context of an existing activity, so you must use the Intent.FLAG_ACTIVITY_NEW_TASK launch flag in the Intent. (Activities after the first in the array are started in the context of the previous activity in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.)

The last intent in the array represents the key for the PendingIntent. In other words, it is the significant element for matching (as done with the single intent given togetActivity(Context, int, Intent, int), its content will be the subject of replacement by send(Context, int, Intent) andFLAG_UPDATE_CURRENT, etc. This is because it is the most specific of the supplied intents, and the UI the user actually sees when the intents are started.

Parameters

context	The Context in which this PendingIntent should start the activity.
requestCode	Private request code for the sender (currently not used).
intents	Array of Intents of the activities to be launched.
flags	May be `FLAG_ONE_SHOT`, `FLAG_NO_CREATE`, `FLAG_CANCEL_CURRENT`, `FLAG_UPDATE_CURRENT`, or any of the flags as supported by`Intent.fillIn()` to control which unspecified parts of the intent that can be supplied when the actual send happens. 當(dāng)我們使用Inent.fillIn()所支持的flags時，表示其Intent的數(shù)據(jù)項可以被send方法的Intent參數(shù)覆蓋重寫。

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if FLAG_NO_CREATE has been supplied.

getService方法

該方法將系統(tǒng)取得一個用于啟動一個Service的PendingIntent對象.

public static PendingIntent getService (Context context, int requestCode, Intent intent, int flags)

Since: API Level 1

Retrieve a PendingIntent that will start a service, like calling Context.startService(). The start arguments given to the service will come from the extras of the Intent.

Parameters

context	The Context in which this PendingIntent should start the service.
requestCode	Private request code for the sender (currently not used).
intent	An Intent describing the service to be started.
flags	May be `FLAG_ONE_SHOT`, `FLAG_NO_CREATE`, `FLAG_CANCEL_CURRENT`, `FLAG_UPDATE_CURRENT`, or any of the flags as supported by`Intent.fillIn()` to control which unspecified parts of the intent that can be supplied when the actual send happens. 當(dāng)我們使用Intent.fillIn()方法的flags時，它表示其Intent的數(shù)據(jù)項可以被send方法的Intent參數(shù)覆蓋重寫。

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if FLAG_NO_CREATE has been supplied.

getBroadcast方法

該方法將從系統(tǒng)取得一個用于向BroadcastReceiver的Intent廣播的PendingIntent對象

public static PendingIntent getBroadcast (Context context, int requestCode, Intent intent, int flags)

Since: API Level 1

Retrieve a PendingIntent that will perform a broadcast, like calling Context.sendBroadcast().

Parameters

context	The Context in which this PendingIntent should perform the broadcast.
requestCode	Private request code for the sender (currently not used).
intent	The Intent to be broadcast.
flags	May be `FLAG_ONE_SHOT`, `FLAG_NO_CREATE`, `FLAG_CANCEL_CURRENT`, `FLAG_UPDATE_CURRENT`, or any of the flags as supported by`Intent.fillIn()` to control which unspecified parts of the intent that can be supplied when the actual send happens. 當(dāng)我們使用Intent.fillIn()方法的flags時，它表示其Intent的數(shù)據(jù)項可以被send方法的Intent參數(shù)覆蓋重寫。

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if FLAG_NO_CREATE has been supplied.

send系列方法

該系列主要用于觸發(fā)PendingIntent的Intent行為。用其Intent或啟動一個Activity，或啟動一個Service，或向BroadcastReceiver發(fā)送Intent廣播。

public void send ()

Since: API Level 1

Perform the operation associated with this PendingIntent.

Throws

PendingIntent.CanceledException	Throws CanceledException if the PendingIntent is no longer allowing more intents to be sent through it.

public void send (Context context, int code, Intent intent)

Since: API Level 1

Perform the operation associated with this PendingIntent, allowing the caller to specify information about the Intent to use.

Parameters

context	The Context of the caller. 該參數(shù)是因為intent參數(shù)才需要提供的，所用如果你的intent參數(shù)不為null的話，該參數(shù)也不能為null.
code	Result code to supply back to the PendingIntent's target.
intent	Additional Intent data. See `Intent.fillIn()` for information on how this is applied to the original Intent.

Throws

PendingIntent.CanceledException	Throws CanceledException if the PendingIntent is no longer allowing more intents to be sent through it.

public void send (int code, PendingIntent.OnFinished onFinished, Handler handler)

Since: API Level 1

Perform the operation associated with this PendingIntent, allowing the caller to be notified when the send has completed.

Parameters

code	Result code to supply back to the PendingIntent's target.
onFinished	The object to call back on when the send has completed, or null for no callback. 通過該參數(shù)，我們可以設(shè)置在Intent發(fā)送成功后的回調(diào)函數(shù)。
handler	Handler identifying the thread on which the callback should happen. If null, the callback will happen from the thread pool of the process. 用于說明onFinished參數(shù)指定的回調(diào)函數(shù)，最終在哪個Handler中進(jìn)行調(diào)用。

Throws

PendingIntent.CanceledException	Throws CanceledException if the PendingIntent is no longer allowing more intents to be sent through it.

public void send (Context context, int code, Intent intent, PendingIntent.OnFinished onFinished, Handler handler)

Since: API Level 1

Perform the operation associated with this PendingIntent, allowing the caller to specify information about the Intent to use and be notified when the send has completed.

For the intent parameter, a PendingIntent often has restrictions on which fields can be supplied here, based on how the PendingIntent was retrieved ingetActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int), or getService(Context, int, Intent, int).

Parameters

context	The Context of the caller. This may be null if `intent` is also null. 該參數(shù)是因為intent參數(shù)才需要提供的，一般是當(dāng)前的context，如果你的intent參數(shù)不為null的話，該函數(shù)也不能為null.
code	Result code to supply back to the PendingIntent's target.
intent	Additional Intent data. See `Intent.fillIn()` for information on how this is applied to the original Intent. Use null to not modify the original Intent.
onFinished	The object to call back on when the send has completed, or null for no callback. 通過該參數(shù)，我們可以指定Intent發(fā)送成功后的回調(diào)函數(shù)。
handler	Handler identifying the thread on which the callback should happen. If null, the callback will happen from the thread pool of the process. 該參數(shù)說明onFinished參數(shù)指定的回調(diào)函數(shù)將在哪個Handler中進(jìn)行調(diào)用。

Throws

PendingIntent.CanceledException	Throws CanceledException if the PendingIntent is no longer allowing more intents to be sent through it.

cancel()函數(shù)

public void cancel ()

Since: API Level 1

Cancel a currently active PendingIntent. Only the original application owning an PendingIntent can cancel it.

只有PengdingIntent的原應(yīng)用程序才能調(diào)用cancel()來把它從系統(tǒng)中移除掉。

getTargetPackage()函數(shù)

public String getTargetPackage ()

Since: API Level 1

Return the package name of the application that created this PendingIntent, that is the identity under which you will actually be sending the Intent. The returned string is supplied by the system, so that an application can not spoof its package.

Returns

The package name of the PendingIntent, or null if there is none associated with it.

posted on 2012-03-15 22:22 life02 閱讀(1883) 評論(0) 編輯收藏引用所屬分類: Android開發(fā)

只有注冊用戶登錄后才能發(fā)表評論。
【推薦】100%開源！大型工業(yè)跨平臺軟件C++源碼提供，建模，組態(tài)！

相關(guān)文章: 動態(tài)增加屏幕（轉(zhuǎn)載） sd卡中刪除一個文件遍歷SD卡及刪除、重命名文件(轉(zhuǎn)載) Android 從sd卡讀取XML文件并解析（轉(zhuǎn)載） android SD卡文件的讀寫(z轉(zhuǎn)載) layout居中 Android開發(fā)之SD卡上文件操作（轉(zhuǎn)） eclipse顯示行號 An internal error occurred during: "Launching New_configuration" android 中通過 aidl 傳遞map對象（轉(zhuǎn)載）

網(wǎng)站導(dǎo)航: 博客園 IT新聞 BlogJava 博問 Chat2DB 管理

life02

常用鏈接

留言簿(4)

隨筆分類(179)

隨筆檔案(197)

文章分類(1)

文章檔案(3)

收藏夾(16)

Android開發(fā)

c++blog——游戲

c++學(xué)習(xí)

QQblog

阿里巴巴

筆試

技術(shù)網(wǎng)站

游戲?qū)W習(xí)

搜索

最新評論

閱讀排行榜

評論排行榜

PendingIntent詳解

public static PendingIntent getActivity (Context context, int requestCode, Intent intent, int flags)

Parameters

Returns

public static PendingIntent getActivities (Context context, int requestCode, Intent[] intents, int flags)

Parameters

Returns

public static PendingIntent getService (Context context, int requestCode, Intent intent, int flags)

Parameters

Returns

public static PendingIntent getBroadcast (Context context, int requestCode, Intent intent, int flags)

Parameters

Returns

public void send ()

Throws

public void send (Context context, int code, Intent intent)

Parameters

Throws

public void send (int code, PendingIntent.OnFinished onFinished, Handler handler)

Parameters

Throws

public void send (Context context, int code, Intent intent, PendingIntent.OnFinished onFinished, Handler handler)

Parameters

Throws

public void cancel ()

public String getTargetPackage ()

Returns