ResolveInfo
public class ResolveInfo
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.content.pm.ResolveInfo |
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 |
---|
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 |
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 |
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 | |
---|---|
Fields
activityInfo
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
public IntentFilter filter
The IntentFilter that was matched for this ResolveInfo.
icon
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
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
public boolean isInstantAppAvailable
Whether or not an instant app is available for the resolved intent.
labelRes
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
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
public CharSequence nonLocalizedLabel
The actual string retrieve from labelRes or null if none was provided.
preferredOrder
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
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
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
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
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
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
Public methods
describeContents
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 CONTENTS_FILE_DESCRIPTOR |
dump
public void dump (Printer pw, String prefix)
Parameters | |
---|---|
pw | Printer |
prefix | String |
getIconResource
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
public boolean isCrossProfileIntentForwarderActivity ()
Returns whether this resolution represents the intent forwarder activity.
Returns | |
---|---|
boolean | whether this resolution represents the intent forwarder activity |
loadIcon
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
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
public String toString ()
Returns a string representation of the object.
Returns | |
---|---|
String | a string representation of the object. |
writeToParcel
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 Parcelable.PARCELABLE_WRITE_RETURN_VALUE , and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.