to top
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 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()
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

Since: API Level 1

public ActivityInfo activityInfo

Since: API Level 1

The activity or broadcast receiver that corresponds to this resolution match, if this resolution is for an activity or broadcast receiver. One and only one of this and serviceInfo must be non-null.

public IntentFilter filter

Since: API Level 1

The IntentFilter that was matched for this ResolveInfo.

public int icon

Since: 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

Since: 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

Since: 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

Since: 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

Since: API Level 1

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

public int preferredOrder

Since: 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

Since: 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 String resolvePackageName

Since: 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

Since: API Level 1

The service that corresponds to this resolution match, if this resolution is for a service. One and only one of this and activityInfo must be non-null.

public int specificIndex

Since: 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 ()

Since: API Level 1

Public Methods

public int describeContents ()

Since: 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)

Since: API Level 1

public final int getIconResource ()

Since: 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)

Since: 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)

Since: 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 ()

Since: 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)

Since: 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.