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)
Android APIs
public class

ResolveInfo

extends Object
implements Parcelable
java.lang.Object
   ↳ android.content.pm.ResolveInfo

Class Overview

Information that is returned from resolving an intent against an IntentFilter. This partially corresponds to information collected from the AndroidManifest.xml's <intent> tags.

Summary

Nested Classes
class ResolveInfo.DisplayNameComparator  
[Expand]
Inherited Constants
From interface android.os.Parcelable
Fields
public static final Creator < ResolveInfo > CREATOR
public ActivityInfo activityInfo The activity or broadcast receiver that corresponds to this resolution match, if this resolution is for an activity or broadcast receiver.
public IntentFilter filter The IntentFilter that was matched for this ResolveInfo.
public int icon A drawable resource identifier (in the package's resources) of this match's icon.
public boolean isDefault This filter has specified the Intent.CATEGORY_DEFAULT, meaning it would like to be considered a default action that the user can perform on this data.
public int labelRes A string resource identifier (in the package's resources) of this match's label.
public int match The system's evaluation of how well the activity matches the IntentFilter.
public CharSequence nonLocalizedLabel The actual string retrieve from labelRes or null if none was provided.
public int preferredOrder Order of result according to the user's preference.
public int priority The declared priority of this match.
public ProviderInfo providerInfo The provider that corresponds to this resolution match, if this resolution is for a provider.
public String resolvePackageName Optional -- if non-null, the labelRes and icon resources will be loaded from this package, rather than the one containing the resolved component.
public ServiceInfo serviceInfo The service that corresponds to this resolution match, if this resolution is for a service.
public int specificIndex Only set when returned by queryIntentActivityOptions(ComponentName, Intent[], Intent, int) , this tells you which of the given specific intents this result came from.
Public Constructors
ResolveInfo ()
ResolveInfo ( ResolveInfo orig)
Public Methods
int describeContents ()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
void dump ( Printer pw, String prefix)
final int getIconResource ()
Return the icon resource identifier to use for this match.
Drawable loadIcon ( PackageManager pm)
Retrieve the current graphical icon associated with this resolution.
CharSequence loadLabel ( PackageManager pm)
Retrieve the current textual label associated with this resolution.
String toString ()
Returns a string containing a concise, human-readable description of this object.
void writeToParcel ( Parcel dest, int parcelableFlags)
Flatten this object in to a Parcel.
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Fields

public static final Creator < ResolveInfo > CREATOR

Added in API level 1

public ActivityInfo activityInfo

Added in API level 1

The activity or broadcast receiver that corresponds to this resolution match, if this resolution is for an activity or broadcast receiver. Exactly one of activityInfo , serviceInfo , or providerInfo will be non-null.

public IntentFilter filter

Added in API level 1

The IntentFilter that was matched for this ResolveInfo.

public int icon

Added in API level 1

A drawable resource identifier (in the package's resources) of this match's icon. From the "icon" attribute or, if not set, 0.

public boolean isDefault

Added in API level 1

This filter has specified the Intent.CATEGORY_DEFAULT, meaning it would like to be considered a default action that the user can perform on this data.

public int labelRes

Added in API level 1

A string resource identifier (in the package's resources) of this match's label. From the "label" attribute or, if not set, 0.

public int match

Added in API level 1

The system's evaluation of how well the activity matches the IntentFilter. This is a match constant, a combination of IntentFilter.MATCH_CATEGORY_MASK and IntentFiler.MATCH_ADJUSTMENT_MASK .

public CharSequence nonLocalizedLabel

Added in API level 1

The actual string retrieve from labelRes or null if none was provided.

public int preferredOrder

Added in API level 1

Order of result according to the user's preference. If the user has not set a preference for this result, the value is 0; higher values are a higher priority.

public int priority

Added in API level 1

The declared priority of this match. Comes from the "priority" attribute or, if not set, defaults to 0. Higher values are a higher priority.

public ProviderInfo providerInfo

The provider that corresponds to this resolution match, if this resolution is for a provider. Exactly one of activityInfo , serviceInfo , or providerInfo will be non-null.

public String resolvePackageName

Added in API level 5

Optional -- if non-null, the labelRes and icon resources will be loaded from this package, rather than the one containing the resolved component.

public ServiceInfo serviceInfo

Added in API level 1

The service that corresponds to this resolution match, if this resolution is for a service. Exactly one of activityInfo , serviceInfo , or providerInfo will be non-null.

public int specificIndex

Added in API level 1

Only set when returned by queryIntentActivityOptions(ComponentName, Intent[], Intent, int) , this tells you which of the given specific intents this result came from. 0 is the first in the list, < 0 means it came from the generic Intent query.

Public Constructors

public ResolveInfo ()

Added in API level 1

public ResolveInfo ( ResolveInfo orig)

Public Methods

public int describeContents ()

Added in API level 1

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Returns
  • a bitmask indicating the set of special object types marshalled by the Parcelable.

public void dump ( Printer pw, String prefix)

Added in API level 1

public final int getIconResource ()

Added in API level 1

Return the icon resource identifier to use for this match. If the match defines an icon, that is used; else if the activity defines an icon, that is used; else, the application icon is used.

Returns
  • The icon associated with this match.

public Drawable loadIcon ( PackageManager pm)

Added in API level 1

Retrieve the current graphical icon associated with this resolution. This will call back on the given PackageManager to load the icon from the application.

Parameters
pm A PackageManager from which the icon can be loaded; usually the PackageManager from which you originally retrieved this item.
Returns
  • Returns a Drawable containing the resolution's icon. If the item does not have an icon, the default activity icon is returned.

public CharSequence loadLabel ( PackageManager pm)

Added in API level 1

Retrieve the current textual label associated with this resolution. This will call back on the given PackageManager to load the label from the application.

Parameters
pm A PackageManager from which the label can be loaded; usually the PackageManager from which you originally retrieved this item.
Returns
  • Returns a CharSequence containing the resolutions's label. If the item does not have a label, its name is returned.

public String toString ()

Added in API level 1

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

          getClass().getName() + '@' + Integer.toHexString(hashCode())
         

See Writing a useful toString method if you intend implementing your own toString method.

Returns
  • a printable representation of this object.

public void writeToParcel ( Parcel dest, int parcelableFlags)

Added in API level 1

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 .