public class

PackageItemInfo

extends Object
java.lang.Object
   ↳ android.content.pm.PackageItemInfo
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

Base class containing information common to all package items held by the package manager. This provides a very common basic set of attributes: a label, icon, and meta-data. This class is not intended to be used by itself; it is simply here to share common definitions between all items returned by the package manager. As such, it does not itself implement Parcelable, but does provide convenience methods to assist in the implementation of Parcelable in subclasses.

Summary

Nested Classes
class PackageItemInfo.DisplayNameComparator  
Fields
public int icon A drawable resource identifier (in the package's resources) of this component's icon.
public int labelRes A string resource identifier (in the package's resources) of this component's label.
public Bundle metaData Additional meta-data associated with this component.
public String name Public name of this item.
public CharSequence nonLocalizedLabel The string provided in the AndroidManifest file, if any.
public String packageName Name of the package that this item is in.
Public Constructors
PackageItemInfo()
PackageItemInfo(PackageItemInfo orig)
Protected Constructors
PackageItemInfo(Parcel source)
Public Methods
Drawable loadIcon(PackageManager pm)
Retrieve the current graphical icon associated with this item.
CharSequence loadLabel(PackageManager pm)
Retrieve the current textual label associated with this item.
XmlResourceParser loadXmlMetaData(PackageManager pm, String name)
Load an XML resource attached to the meta-data of this item.
void writeToParcel(Parcel dest, int parcelableFlags)
Protected Methods
void dumpBack(Printer pw, String prefix)
void dumpFront(Printer pw, String prefix)
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public int icon

Since: API Level 1

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

public int labelRes

Since: API Level 1

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

public Bundle metaData

Since: API Level 1

Additional meta-data associated with this component. This field will only be filled in if you set the GET_META_DATA flag when requesting the info.

public String name

Since: API Level 1

Public name of this item. From the "android:name" attribute.

public CharSequence nonLocalizedLabel

Since: API Level 1

The string provided in the AndroidManifest file, if any. You probably don't want to use this. You probably want getApplicationLabel(ApplicationInfo)

public String packageName

Since: API Level 1

Name of the package that this item is in.

Public Constructors

public PackageItemInfo ()

Since: API Level 1

public PackageItemInfo (PackageItemInfo orig)

Since: API Level 1

Protected Constructors

protected PackageItemInfo (Parcel source)

Since: API Level 1

Public Methods

public Drawable loadIcon (PackageManager pm)

Since: API Level 1

Retrieve the current graphical icon associated with this item. 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 item's icon. If the item does not have an icon, the item's default icon is returned such as the default activity icon.

public CharSequence loadLabel (PackageManager pm)

Since: API Level 1

Retrieve the current textual label associated with this item. 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 item's label. If the item does not have a label, its name is returned.

public XmlResourceParser loadXmlMetaData (PackageManager pm, String name)

Since: API Level 1

Load an XML resource attached to the meta-data of this item. This will retrieved the name meta-data entry, and if defined call back on the given PackageManager to load its XML file from the application.

Parameters
pm A PackageManager from which the XML can be loaded; usually the PackageManager from which you originally retrieved this item.
name Name of the meta-date you would like to load.
Returns
  • Returns an XmlPullParser you can use to parse the XML file assigned as the given meta-data. If the meta-data name is not defined or the XML resource could not be found, null is returned.

public void writeToParcel (Parcel dest, int parcelableFlags)

Since: API Level 1

Protected Methods

protected void dumpBack (Printer pw, String prefix)

Since: API Level 1

protected void dumpFront (Printer pw, String prefix)

Since: API Level 1