Most visited

Recently visited

Results for

WallpaperInfo

public final class WallpaperInfo
extends Object implements Parcelable

java.lang.Object
↳	android.app.WallpaperInfo

This class is used to specify meta information of a wallpaper service.

Summary

XML attributes
`android:supportsMultipleDisplays`	Indicates that this wallpaper service can support multiple engines to render on each surface independently.

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<WallpaperInfo>`	`CREATOR` Used to make this class parcelable.

Public constructors
`WallpaperInfo(Context context, ResolveInfo service)` Constructor.

Public methods
`int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`void`	`dump(Printer pw, String prefix)`
`ComponentName`	`getComponent()` Return the component of the service that implements this wallpaper.
`String`	`getPackageName()` Return the .apk package that implements this wallpaper.
`ServiceInfo`	`getServiceInfo()` Return the raw information about the Service implementing this wallpaper.
`String`	`getServiceName()` Return the class name of the service component that implements this wallpaper.
`String`	`getSettingsActivity()` Return the class name of an activity that provides a settings UI for the wallpaper.
`Uri`	`getSettingsSliceUri()` Returns an URI that provides a settings `Slice` for this wallpaper.
`boolean`	`getShowMetadataInPreview()` Queries whether any metadata should be shown when previewing the wallpaper.
`CharSequence`	`loadAuthor(PackageManager pm)` Return a string indicating the author(s) of this wallpaper.
`CharSequence`	`loadContextDescription(PackageManager pm)` Retrieves a title of the URI that specifies a link for further context about this wallpaper.
`Uri`	`loadContextUri(PackageManager pm)` Returns an URI that specifies a link for further context about this wallpaper.
`CharSequence`	`loadDescription(PackageManager pm)` Return a brief summary of this wallpaper's behavior.
`Drawable`	`loadIcon(PackageManager pm)` Load the user-displayed icon for this wallpaper.
`CharSequence`	`loadLabel(PackageManager pm)` Load the user-displayed label for this wallpaper.
`Drawable`	`loadThumbnail(PackageManager pm)` Load the thumbnail image for this wallpaper.
`boolean`	`supportsMultipleDisplays()` Returns whether this wallpaper service can support multiple engines to render on each surface independently.
`String`	`toString()` Returns a string representation of the object.
`void`	`writeToParcel(Parcel dest, int flags)` Used to package this object into 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 timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

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.

XML attributes

android:supportsMultipleDisplays

Indicates that this wallpaper service can support multiple engines to render on each surface independently. An example use case is a multi-display set-up where the wallpaper service can render surfaces to each of the connected displays. Corresponds to WallpaperInfo.supportsMultipleDisplays()

May be a boolean value, such as "true" or "false".

Related methods:

supportsMultipleDisplays()

Fields

CREATOR

public static final Creator<WallpaperInfo> CREATOR

Used to make this class parcelable.

Public constructors

WallpaperInfo

public WallpaperInfo (Context context, 
                ResolveInfo service)

Constructor.

Parameters
`context`	`Context`: The Context in which we are parsing the wallpaper.
`service`	`ResolveInfo`: The ResolveInfo returned from the package manager about this wallpaper's component.

Throws
`IOException`
`XmlPullParserException`

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`

getComponent

public ComponentName getComponent ()

Return the component of the service that implements this wallpaper.

Returns
`ComponentName`

getPackageName

public String getPackageName ()

Return the .apk package that implements this wallpaper.

Returns
`String`

getServiceInfo

public ServiceInfo getServiceInfo ()

Return the raw information about the Service implementing this wallpaper. Do not modify the returned object.

Returns
`ServiceInfo`

getServiceName

public String getServiceName ()

Return the class name of the service component that implements this wallpaper.

Returns
`String`

getSettingsActivity

public String getSettingsActivity ()

Return the class name of an activity that provides a settings UI for the wallpaper. You can launch this activity be starting it with an Intent whose action is MAIN and with an explicit ComponentName composed of getPackageName() and the class name returned here.

null will be returned if there is no settings activity associated with the wallpaper.

Returns
`String`

getSettingsSliceUri

public Uri getSettingsSliceUri ()

Returns an URI that provides a settings Slice for this wallpaper. The wallpaper should implement a SliceProvider associated with this URI. The system will display the Slice in the customization section while previewing the live wallpaper. Because this URI is accessible to other apps, it is recommended to protect it with the android.permission.BIND_WALLPAPER permission.

null will be returned if there is no settings Slice URI associated with the wallpaper.

Returns
`Uri`	The URI.

getShowMetadataInPreview

public boolean getShowMetadataInPreview ()

Queries whether any metadata should be shown when previewing the wallpaper. If this value is set to true, any component that shows a preview of this live wallpaper should also show accompanying information like loadLabel(PackageManager), loadDescription(PackageManager), loadAuthor(PackageManager) and loadContextDescription(android.content.pm.PackageManager), so the user gets to know further information about this wallpaper.

Returns
`boolean`	Whether any metadata should be shown when previewing the wallpaper.

loadAuthor

public CharSequence loadAuthor (PackageManager pm)

Return a string indicating the author(s) of this wallpaper.

Parameters
`pm`	`PackageManager`

Returns
`CharSequence`

Throws
`Resources.NotFoundException`

loadContextDescription

public CharSequence loadContextDescription (PackageManager pm)

Retrieves a title of the URI that specifies a link for further context about this wallpaper.

Parameters
`pm`	`PackageManager`: An instance of `PackageManager` to retrieve the title.

Returns
`CharSequence`	The title.

Throws
`Resources.NotFoundException`

loadContextUri

public Uri loadContextUri (PackageManager pm)

Returns an URI that specifies a link for further context about this wallpaper.

Parameters
`pm`	`PackageManager`: An instance of `PackageManager` to retrieve the URI.

Returns
`Uri`	The URI.

Throws
`Resources.NotFoundException`

loadDescription

public CharSequence loadDescription (PackageManager pm)

Return a brief summary of this wallpaper's behavior.

Parameters
`pm`	`PackageManager`

Returns
`CharSequence`

Throws
`Resources.NotFoundException`

loadIcon

public Drawable loadIcon (PackageManager pm)

Load the user-displayed icon for this wallpaper.

Parameters
`pm`	`PackageManager`: Supply a PackageManager used to load the wallpaper's resources.

Returns
`Drawable`

loadLabel

public CharSequence loadLabel (PackageManager pm)

Load the user-displayed label for this wallpaper.

Parameters
`pm`	`PackageManager`: Supply a PackageManager used to load the wallpaper's resources.

Returns
`CharSequence`

loadThumbnail

public Drawable loadThumbnail (PackageManager pm)

Load the thumbnail image for this wallpaper.

Parameters
`pm`	`PackageManager`: Supply a PackageManager used to load the wallpaper's resources.

Returns
`Drawable`

supportsMultipleDisplays

public boolean supportsMultipleDisplays ()

Returns whether this wallpaper service can support multiple engines to render on each surface independently. An example use case is a multi-display set-up where the wallpaper service can render surfaces to each of the connected displays.

This corresponds to the value R.styleable.Wallpaper_supportsMultipleDisplays in the XML description of the wallpaper.

The default value is false.

Related XML Attributes:

android:supportsMultipleDisplays

Returns
`boolean`	`true` if multiple engines can render independently on each surface.

See also:

toString

public String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())

Returns
`String`	a string representation of the object.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Used to package this object into a Parcel.

Parameters
`dest`	`Parcel`: The `Parcel` to be written.
`flags`	`int`: The flags used for parceling.

Interfaces

Classes

Exceptions

Most visited

Recently visited

Results for

WallpaperInfo

Summary

XML attributes

Inherited constants

Fields

Public constructors

Public methods

Inherited methods

XML attributes

android:supportsMultipleDisplays

Fields

CREATOR

Public constructors

WallpaperInfo

Public methods

describeContents

dump

getComponent

getPackageName

getServiceInfo

getServiceName

getSettingsActivity

getSettingsSliceUri

getShowMetadataInPreview

loadAuthor

loadContextDescription

loadContextUri

loadDescription

loadIcon

loadLabel

loadThumbnail

supportsMultipleDisplays

toString

writeToParcel