Added in API level 11

BroadcastReceiver.PendingResult


public static class BroadcastReceiver.PendingResult
extends Object

java.lang.Object
   ↳ android.content.BroadcastReceiver.PendingResult


State for a result that is pending for a broadcast receiver. Returned by goAsync() while in BroadcastReceiver.onReceive(). This allows you to return from onReceive() without having the broadcast terminate; you must call finish() once you are done with the broadcast. This allows you to process the broadcast off of the main thread of your app.

Note on threading: the state inside of this class is not itself thread-safe. However, you can use it from any thread if you make sure that you do not have races. Typically this means you will hand the entire object to another thread, which will be solely responsible for setting any results and finally calling finish().

Summary

Public methods

final void abortBroadcast()

Version of BroadcastReceiver.abortBroadcast() for asynchronous broadcast handling.

final void clearAbortBroadcast()

Version of BroadcastReceiver.clearAbortBroadcast() for asynchronous broadcast handling.

final void finish()

Finish the broadcast.

final boolean getAbortBroadcast()

Version of BroadcastReceiver.getAbortBroadcast() for asynchronous broadcast handling.

final int getResultCode()

Version of BroadcastReceiver.getResultCode() for asynchronous broadcast handling.

final String getResultData()

Version of BroadcastReceiver.getResultData() for asynchronous broadcast handling.

final Bundle getResultExtras(boolean makeMap)

Version of BroadcastReceiver.getResultExtras(boolean) for asynchronous broadcast handling.

final void setResult(int code, String data, Bundle extras)

Version of BroadcastReceiver.setResult(int, String, Bundle) for asynchronous broadcast handling.

final void setResultCode(int code)

Version of BroadcastReceiver.setResultCode(int) for asynchronous broadcast handling.

final void setResultData(String data)

Version of BroadcastReceiver.setResultData(String) for asynchronous broadcast handling.

final void setResultExtras(Bundle extras)

Version of BroadcastReceiver.setResultExtras(Bundle) for asynchronous broadcast handling.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

abortBroadcast

Added in API level 11
public final void abortBroadcast ()

Version of BroadcastReceiver.abortBroadcast() for asynchronous broadcast handling.

clearAbortBroadcast

Added in API level 11
public final void clearAbortBroadcast ()

Version of BroadcastReceiver.clearAbortBroadcast() for asynchronous broadcast handling.

finish

Added in API level 11
public final void finish ()

Finish the broadcast. The current result will be sent and the next broadcast will proceed.

getAbortBroadcast

Added in API level 11
public final boolean getAbortBroadcast ()

Version of BroadcastReceiver.getAbortBroadcast() for asynchronous broadcast handling.

Returns
boolean

getResultCode

Added in API level 11
public final int getResultCode ()

Version of BroadcastReceiver.getResultCode() for asynchronous broadcast handling.

Returns
int

getResultData

Added in API level 11
public final String getResultData ()

Version of BroadcastReceiver.getResultData() for asynchronous broadcast handling.

Returns
String

getResultExtras

Added in API level 11
public final Bundle getResultExtras (boolean makeMap)

Version of BroadcastReceiver.getResultExtras(boolean) for asynchronous broadcast handling.

Parameters
makeMap boolean

Returns
Bundle

setResult

Added in API level 11
public final void setResult (int code, 
                String data, 
                Bundle extras)

Version of BroadcastReceiver.setResult(int, String, Bundle) for asynchronous broadcast handling.

Parameters
code int

data String

extras Bundle

setResultCode

Added in API level 11
public final void setResultCode (int code)

Version of BroadcastReceiver.setResultCode(int) for asynchronous broadcast handling.

Parameters
code int

setResultData

Added in API level 11
public final void setResultData (String data)

Version of BroadcastReceiver.setResultData(String) for asynchronous broadcast handling.

Parameters
data String

setResultExtras

Added in API level 11
public final void setResultExtras (Bundle extras)

Version of BroadcastReceiver.setResultExtras(Bundle) for asynchronous broadcast handling.

Parameters
extras Bundle