Home Original page

ResolveInfo  |  API reference  |  Android Developers

public class ResolveInfo
extends Object implements Parcelable


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

Inherited constants

From interface android.os.Parcelable

int CONTENTS_FILE_DESCRIPTOR

Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor.

int PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel(Parcel, int): the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout 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 boolean isInstantAppAvailable

Whether or not an instant app is available for the resolved intent.

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 PackageManager.queryIntentActivityOptions, 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 instance's marshaled representation.

void dump(Printer pw, String prefix)
final int getIconResource()

Return the icon resource identifier to use for this match.

boolean isCrossProfileIntentForwarderActivity()

Returns whether this resolution represents the intent forwarder activity.

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 representation of the object.

void writeToParcel(Parcel dest, int parcelableFlags)

Flatten this object in to a Parcel.

Inherited methods

From class java.lang.Object

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.

From interface android.os.Parcelable

abstract int describeContents()

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

abstract void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Fields

CREATOR

Added in API level 1 

public static final Creator<ResolveInfo> CREATOR

activityInfo

Added in API level 1 

public ActivityInfo activityInfo

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.

filter

Added in API level 1 

public IntentFilter filter

The IntentFilter that was matched for this ResolveInfo.

icon

Added in API level 1 

public int icon

A drawable resource identifier (in the package's resources) of this match's icon. From the "icon" attribute or, if not set, 0. It is set only if the icon can be obtained by resource id alone.

isDefault

Added in API level 1 

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.

isInstantAppAvailable

Added in API level 26 

public boolean isInstantAppAvailable

Whether or not an instant app is available for the resolved intent.

labelRes

Added in API level 1 

public int labelRes

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

match

Added in API level 1 

public int match

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.

nonLocalizedLabel

Added in API level 1 

public CharSequence nonLocalizedLabel

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

preferredOrder

Added in API level 1 

public int preferredOrder

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.

priority

Added in API level 1 

public int priority

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

providerInfo

Added in API level 19 

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.

resolvePackageName

Added in API level 5 

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.

serviceInfo

Added in API level 1 

public ServiceInfo serviceInfo

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.

specificIndex

Added in API level 1 

public int specificIndex

Only set when returned by PackageManager.queryIntentActivityOptions, 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

ResolveInfo

Added in API level 1 

public ResolveInfo ()

ResolveInfo

Added in API level 17 

public ResolveInfo (ResolveInfo orig)
Parameters
orig ResolveInfo

Public methods

describeContents

Added in API level 1 

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.
Value is either 0 or

dump

Added in API level 1 

public void dump (Printer pw, 
                String prefix)
Parameters
pw Printer
prefix String

getIconResource

Added in API level 1 

public final int getIconResource ()

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
int The icon associated with this match.

isCrossProfileIntentForwarderActivity

Added in API level 30 

public boolean isCrossProfileIntentForwarderActivity ()

Returns whether this resolution represents the intent forwarder activity.

Returns
boolean whether this resolution represents the intent forwarder activity

loadIcon

Added in API level 1 

public Drawable loadIcon (PackageManager pm)

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 PackageManager: A PackageManager from which the icon can be loaded; usually the PackageManager from which you originally retrieved this item.
Returns
Drawable Returns a Drawable containing the resolution's icon. If the item does not have an icon, the default activity icon is returned.

loadLabel

Added in API level 1 

public CharSequence loadLabel (PackageManager pm)

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 PackageManager: A PackageManager from which the label can be loaded; usually the PackageManager from which you originally retrieved this item.
This value cannot be null.
Returns
CharSequence Returns a CharSequence containing the resolutions's label. If the item does not have a label, its name is returned.
This value cannot be null.

toString

Added in API level 1 

public String toString ()

Returns a string representation of the object.

Returns
String a string representation of the object.

writeToParcel

Added in API level 1 

public void writeToParcel (Parcel dest, 
                int parcelableFlags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written.
This value cannot be null.
parcelableFlags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.
Value is either 0 or a combination of the following: