RemoteCallbackList.GetBroadcastItem(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Retrieve an item in the active broadcast that was previously started
with #beginBroadcast
.
[Android.Runtime.Register("getBroadcastItem", "(I)Landroid/os/IInterface;", "GetGetBroadcastItem_IHandler")]
public virtual Java.Lang.Object? GetBroadcastItem (int index);
[<Android.Runtime.Register("getBroadcastItem", "(I)Landroid/os/IInterface;", "GetGetBroadcastItem_IHandler")>]
abstract member GetBroadcastItem : int -> Java.Lang.Object
override this.GetBroadcastItem : int -> Java.Lang.Object
Parameters
- index
- Int32
Which of the registered callbacks you would like to
retrieve. Ranges from 0 to 1-#beginBroadcast
.
Returns
Returns the callback interface that you can call. This will always be non-null.
- Attributes
Remarks
Retrieve an item in the active broadcast that was previously started with #beginBroadcast
. This can <em>only</em> be called after the broadcast is started, and its data is no longer valid after calling #finishBroadcast
.
Note that it is possible for the process of one of the returned callbacks to go away before you call it, so you will need to catch RemoteException
when calling on to the returned object. The callback list itself, however, will take care of unregistering these objects once it detects that it is no longer valid, so you can handle such an exception by simply ignoring it.
Java documentation for android.os.RemoteCallbackList.getBroadcastItem(int)
.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.