Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Added in API level 5

public class

LabeledIntent

extends Intent

java.lang.Object
↳	android.content.Intent
	↳	android.content.pm.LabeledIntent

Class Overview

A special subclass of Intent that can have a custom label/icon associated with it. Primarily for use with ACTION_CHOOSER .

Summary

[Expand]

Inherited Constants

From class android.content.Intent

From interface android.os.Parcelable

Fields
public static final Creator < LabeledIntent >	CREATOR

[Expand]

Inherited Fields

From class android.content.Intent

Public Constructors
	LabeledIntent ( Intent origIntent, String sourcePackage, int labelRes, int icon) Create a labeled intent from the given intent, supplying the label and icon resources for it.
	LabeledIntent ( Intent origIntent, String sourcePackage, CharSequence nonLocalizedLabel, int icon) Create a labeled intent from the given intent, supplying a textual label and icon resource for it.
	LabeledIntent ( String sourcePackage, int labelRes, int icon) Create a labeled intent with no intent data but supplying the label and icon resources for it.
	LabeledIntent ( String sourcePackage, CharSequence nonLocalizedLabel, int icon) Create a labeled intent with no intent data but supplying a textual label and icon resource for it.

Public Methods
int	getIconResource () Return any resource identifier that has been given for the label icon.
int	getLabelResource () Return any resource identifier that has been given for the label text.
CharSequence	getNonLocalizedLabel () Return any concrete text that has been given for the label text.
String	getSourcePackage () Return the name of the package holding label and icon resources.
Drawable	loadIcon ( PackageManager pm) Retrieve the icon associated with this object.
CharSequence	loadLabel ( PackageManager pm) Retrieve the label associated with this object.
void	readFromParcel ( Parcel in)
void	writeToParcel ( Parcel dest, int parcelableFlags) Flatten this object in to a Parcel.

[Expand]

Inherited Methods

From class android.content.Intent

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface android.os.Parcelable

Fields

public static final Creator < LabeledIntent > CREATOR

Added in API level 5

Public Constructors

public LabeledIntent ( Intent origIntent, String sourcePackage, int labelRes, int icon)

Added in API level 5

Create a labeled intent from the given intent, supplying the label and icon resources for it.

Parameters

origIntent	The original Intent to copy.
sourcePackage	The package in which the label and icon live.
labelRes	Resource containing the label, or 0 if none.
icon	Resource containing the icon, or 0 if none.

public LabeledIntent ( Intent origIntent, String sourcePackage, CharSequence nonLocalizedLabel, int icon)

Added in API level 5

Create a labeled intent from the given intent, supplying a textual label and icon resource for it.

Parameters

origIntent	The original Intent to copy.
sourcePackage	The package in which the label and icon live.
nonLocalizedLabel	Concrete text to use for the label.
icon	Resource containing the icon, or 0 if none.

public LabeledIntent ( String sourcePackage, int labelRes, int icon)

Added in API level 5

Create a labeled intent with no intent data but supplying the label and icon resources for it.

Parameters

sourcePackage	The package in which the label and icon live.
labelRes	Resource containing the label, or 0 if none.
icon	Resource containing the icon, or 0 if none.

public LabeledIntent ( String sourcePackage, CharSequence nonLocalizedLabel, int icon)

Added in API level 5

Create a labeled intent with no intent data but supplying a textual label and icon resource for it.

Parameters

sourcePackage	The package in which the label and icon live.
nonLocalizedLabel	Concrete text to use for the label.
icon	Resource containing the icon, or 0 if none.

Public Methods

public int getIconResource ()

Added in API level 5

Return any resource identifier that has been given for the label icon.

public int getLabelResource ()

Added in API level 5

Return any resource identifier that has been given for the label text.

public CharSequence getNonLocalizedLabel ()

Added in API level 5

Return any concrete text that has been given for the label text.

public String getSourcePackage ()

Added in API level 5

Return the name of the package holding label and icon resources.

public Drawable loadIcon ( PackageManager pm)

Added in API level 5

Retrieve the icon associated with this object. If the object does not have a icon, null will be returned, in which case you will probably want to load the icon from the underlying resolved info for the Intent.

public CharSequence loadLabel ( PackageManager pm)

Added in API level 5

Retrieve the label associated with this object. If the object does not have a label, null will be returned, in which case you will probably want to load the label from the underlying resolved info for the Intent.

public void readFromParcel ( Parcel in)

Added in API level 5

public void writeToParcel ( Parcel dest, int parcelableFlags)

Added in API level 5

Flatten this object in to a Parcel.

Parameters

dest	The Parcel in which the object should be written.
parcelableFlags	Additional flags about how the object should be written. May be 0 or `PARCELABLE_WRITE_RETURN_VALUE` .

Results

Classes

Exceptions

LabeledIntent

Class Overview

Summary

Fields

public static final Creator < LabeledIntent > CREATOR

Public Constructors

public LabeledIntent ( Intent origIntent, String sourcePackage, int labelRes, int icon)

Parameters

public LabeledIntent ( Intent origIntent, String sourcePackage, CharSequence nonLocalizedLabel, int icon)

Parameters

public LabeledIntent ( String sourcePackage, int labelRes, int icon)

Parameters

public LabeledIntent ( String sourcePackage, CharSequence nonLocalizedLabel, int icon)

Parameters

Public Methods

public int getIconResource ()

public int getLabelResource ()

public CharSequence getNonLocalizedLabel ()

public String getSourcePackage ()

public Drawable loadIcon ( PackageManager pm)

public CharSequence loadLabel ( PackageManager pm)

public void readFromParcel ( Parcel in)

public void writeToParcel ( Parcel dest, int parcelableFlags)

Parameters