SliceItem

public final class SliceItem
extends Object implements Parcelable

java.lang.Object
   ↳ android.app.slice.SliceItem


A SliceItem is a single unit in the tree structure of a Slice. A SliceItem a piece of content and some hints about what that content means or how it should be displayed. The types of content can be:

  • FORMAT_SLICE
  • FORMAT_TEXT
  • FORMAT_IMAGE
  • FORMAT_ACTION
  • FORMAT_INT
  • FORMAT_TIMESTAMP
  • FORMAT_REMOTE_INPUT
  • FORMAT_BUNDLE
  • The hints that a SliceItem are a set of strings which annotate the content. The hints that are guaranteed to be understood by the system are defined on Slice.

    Summary

    Constants

    String FORMAT_ACTION

    A SliceItem that contains a PendingIntent Note: Actions contain 2 pieces of data, In addition to the pending intent, the item contains a Slice that the action applies to.

    String FORMAT_BUNDLE

    A SliceItem that contains a Bundle.

    String FORMAT_IMAGE

    A SliceItem that contains an Icon

    String FORMAT_INT

    A SliceItem that contains an int.

    String FORMAT_LONG

    A SliceItem that contains a long.

    String FORMAT_REMOTE_INPUT

    A SliceItem that contains a RemoteInput.

    String FORMAT_SLICE

    A SliceItem that contains a Slice

    String FORMAT_TEXT

    A SliceItem that contains a CharSequence

    String FORMAT_TIMESTAMP

    This constant was deprecated in API level P. TO BE REMOVED

    Inherited constants

    Fields

    public static final Creator<SliceItem> CREATOR

    Public methods

    int describeContents()

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

    PendingIntent getAction()
    Bundle getBundle()
    String getFormat()

    Get the format of this SliceItem.

    List<String> getHints()

    Gets all hints associated with this SliceItem.

    Icon getIcon()
    int getInt()
    RemoteInput getRemoteInput()
    Slice getSlice()
    String getSubType()

    Get the sub-type of this SliceItem.

    CharSequence getText()
    long getTimestamp()
    boolean hasHint(String hint)
    void writeToParcel(Parcel dest, int flags)

    Flatten this object in to a Parcel.

    Inherited methods

    Constants

    FORMAT_ACTION

    String FORMAT_ACTION

    A SliceItem that contains a PendingIntent Note: Actions contain 2 pieces of data, In addition to the pending intent, the item contains a Slice that the action applies to.

    Constant Value: "action"

    FORMAT_BUNDLE

    String FORMAT_BUNDLE

    A SliceItem that contains a Bundle.

    Constant Value: "bundle"

    FORMAT_IMAGE

    String FORMAT_IMAGE

    A SliceItem that contains an Icon

    Constant Value: "image"

    FORMAT_INT

    String FORMAT_INT

    A SliceItem that contains an int.

    Constant Value: "int"

    FORMAT_LONG

    String FORMAT_LONG

    A SliceItem that contains a long.

    Constant Value: "long"

    FORMAT_REMOTE_INPUT

    String FORMAT_REMOTE_INPUT

    A SliceItem that contains a RemoteInput.

    Constant Value: "input"

    FORMAT_SLICE

    String FORMAT_SLICE

    A SliceItem that contains a Slice

    Constant Value: "slice"

    FORMAT_TEXT

    String FORMAT_TEXT

    A SliceItem that contains a CharSequence

    Constant Value: "text"

    FORMAT_TIMESTAMP

    String FORMAT_TIMESTAMP

    This constant was deprecated in API level P.
    TO BE REMOVED

    Constant Value: "long"

    Fields

    Public methods

    describeContents

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

    getAction

    PendingIntent getAction ()

    Returns
    PendingIntent The pending intent held by this FORMAT_ACTION SliceItem

    getBundle

    Bundle getBundle ()

    Returns
    Bundle The parcelable held by this FORMAT_BUNDLE SliceItem

    getFormat

    String getFormat ()

    Get the format of this SliceItem.

    The format will be one of the following types supported by the platform:

  • FORMAT_SLICE
  • FORMAT_TEXT
  • FORMAT_IMAGE
  • FORMAT_ACTION
  • FORMAT_INT
  • FORMAT_TIMESTAMP
  • FORMAT_REMOTE_INPUT
  • FORMAT_BUNDLE
  • Returns
    String

    See also:

    getHints

    List<String> getHints ()

    Gets all hints associated with this SliceItem.

    Returns
    List<String> Array of hints.

    This value will never be null.

    Value is HINT_TITLE, HINT_LIST, HINT_LIST_ITEM, HINT_LARGE, HINT_ACTIONS, HINT_SELECTED, HINT_NO_TINT, HINT_SHORTCUT, HINT_HORIZONTAL, HINT_PARTIAL, HINT_SEE_MORE, HINT_KEYWORDS, HINT_ERROR, HINT_TTL, HINT_LAST_UPDATED or HINT_PERMISSION_REQUEST.

    getIcon

    Icon getIcon ()

    Returns
    Icon The icon held by this FORMAT_IMAGE SliceItem

    getInt

    int getInt ()

    Returns
    int The color held by this FORMAT_INT SliceItem

    getRemoteInput

    RemoteInput getRemoteInput ()

    Returns
    RemoteInput The remote input held by this FORMAT_REMOTE_INPUT SliceItem

    getSlice

    Slice getSlice ()

    Returns
    Slice The slice held by this FORMAT_ACTION or FORMAT_SLICE SliceItem

    getSubType

    String getSubType ()

    Get the sub-type of this SliceItem.

    Subtypes provide additional information about the type of this information beyond basic interpretations inferred by getFormat(). For example a slice may contain many FORMAT_TEXT items, but only some of them may be SUBTYPE_MESSAGE.

    Returns
    String

    See also:

    getText

    CharSequence getText ()

    Returns
    CharSequence The text held by this FORMAT_TEXT SliceItem

    getTimestamp

    long getTimestamp ()

    Returns
    long The timestamp held by this FORMAT_TIMESTAMP SliceItem

    hasHint

    boolean hasHint (String hint)

    Parameters
    hint String: The hint to check for

    Value is HINT_TITLE, HINT_LIST, HINT_LIST_ITEM, HINT_LARGE, HINT_ACTIONS, HINT_SELECTED, HINT_NO_TINT, HINT_SHORTCUT, HINT_HORIZONTAL, HINT_PARTIAL, HINT_SEE_MORE, HINT_KEYWORDS, HINT_ERROR, HINT_TTL, HINT_LAST_UPDATED or HINT_PERMISSION_REQUEST.

    Returns
    boolean true if this item contains the given hint

    writeToParcel

    void writeToParcel (Parcel dest, 
                    int flags)

    Flatten this object in to a Parcel.

    Parameters
    dest Parcel: The Parcel in which the object should be written.

    flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.