android.content.pm
Class ResolveInfo

java.lang.Object
  android.content.pm.ResolveInfo

All Implemented Interfaces:

Parcelable

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.

Nested Class Summary

static class

ResolveInfo.DisplayNameComparator

Nested classes/interfaces inherited from interface android.os.Parcelable

Parcelable.Creator<T>

Field Summary

ActivityInfo	activityInfo The activity that corresponds to this resolution match, if this resolution is for an activity.
static Parcelable.Creator<ResolveInfo>	CREATOR
IntentFilter	filter The IntentFilter that was matched for this ResolveInfo.
int	icon A drawable resource identifier (in the package's resources) of this match's icon.
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.
int	labelRes A string resource identifier (in the package's resources) of this match's label.
int	match The system's evaluation of how well the activity matches the IntentFilter.
CharSequence	nonLocalizedLabel The actual string retrieve from labelRes or null if none was provided.
int	preferredOrder Order of result according to the user's preference.
int	priority The declared priority of this match.
ServiceInfo	serviceInfo The service that corresponds to this resolution match, if this resolution is for a service.
int	specificIndex Only set when returned by PackageManager.queryIntentActivityOptions(android.content.ComponentName, android.content.Intent[], android.content.Intent, int), this tells you which of the given specific intents this result came from.

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

ResolveInfo()

Method Summary

int	describeContents() Describe the kinds of special objects contained in this Parcelable's marshalled representation.
void	dump(Printer pw, String prefix)
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 the receiver.
void	writeToParcel(Parcel dest, int parcelableFlags) Flatten this object in to a Parcel.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

activityInfo

public ActivityInfo activityInfo

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

serviceInfo

public ServiceInfo serviceInfo

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.

filter

public IntentFilter filter

The IntentFilter that was matched for this ResolveInfo.

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.

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.

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.

specificIndex

public int specificIndex

Only set when returned by PackageManager.queryIntentActivityOptions(android.content.ComponentName, android.content.Intent[], android.content.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.

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.

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.

nonLocalizedLabel

public CharSequence nonLocalizedLabel

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

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.

CREATOR

public static final Parcelable.Creator<ResolveInfo> CREATOR

Constructor Detail

ResolveInfo

public ResolveInfo()

Method Detail

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

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

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:

The icon associated with this match.

dump

public void dump(Printer pw,
                 String prefix)

toString

public String toString()

Description copied from class: Object

Returns a string containing a concise, human-readable description of the receiver.

Overrides:

toString in class Object

Returns:

String a printable representation for the receiver.

describeContents

public int describeContents()

Description copied from interface: Parcelable

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

Specified by:

describeContents in interface Parcelable

Returns:

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

writeToParcel

public void writeToParcel(Parcel dest,
                          int parcelableFlags)

Description copied from interface: Parcelable

Flatten this object in to a Parcel.

Specified by:

writeToParcel in interface Parcelable

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.PARCELABLE_WRITE_RETURN_VALUE.