LongTextComplicationData
public final class LongTextComplicationData extends ComplicationData
| java.lang.Object | ||
| ↳ | androidx.wear.watchface.complications.data.ComplicationData | |
| ↳ | androidx.wear.watchface.complications.data.LongTextComplicationData | |
Type used for complications where the primary piece of data is a piece of text. The text may be accompanied by an icon and/or a title.
The text is expected to always be displayed.
The title, if provided, it is expected that this field will be displayed.
If a monochromaticImage and a smallImage are both specified then only one should be displayed. If the complication is drawn with a single color it's recommended to choose monochromaticImage and apply a tint. If the complication is rendered with multiple colors it's recommended to choose the smallImage. It's best practice for a ComplicationDataSource to specify both a monochromaticImage and a smallImage.
A data source that wants to serve a LongTextComplicationData must include the following meta data in its manifest (NB the value is a comma separated list):
<meta-data android:name="android.support.wearable.complications.SUPPORTED_TYPES"
android:value="LONG_TEXT"/>
Summary
Nested types |
|---|
public final class LongTextComplicationData.BuilderBuilder for |
Public fields |
|
|---|---|
static final @NonNull ComplicationType |
The |
Public methods |
|
|---|---|
final ComplicationText |
The content description field for accessibility. |
final MonochromaticImage |
A simple |
@NonNull Instant |
getNextChangeInstant(@NonNull Instant afterInstant)Returns the next |
final SmallImage |
A |
final @NonNull ComplicationText |
getText()The body |
final ComplicationText |
getTitle()The optional title |
boolean |
Returns |
@NonNull String |
toString() |
Inherited methods |
||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Public fields
TYPE
public static final @NonNull ComplicationType TYPE
The ComplicationType corresponding to objects of this type.
Public methods
getContentDescription
public final ComplicationText getContentDescription()
The content description field for accessibility.
getMonochromaticImage
public final MonochromaticImage getMonochromaticImage()
A simple MonochromaticImage image that can be tinted by the watch face. If the monochromaticImage is equal to MonochromaticImage.PLACEHOLDER the renderer must treat it as a placeholder rather than rendering normally, its suggested it should be rendered as a light grey box.
getNextChangeInstant
public @NonNull Instant getNextChangeInstant(@NonNull Instant afterInstant)
Returns the next Instant after afterInstant at which any field of the complication may change. If there's no scheduled changes then Instant.MAX will be returned.
getSmallImage
public final SmallImage getSmallImage()
A SmallImage that is expected to cover a small fraction of a watch face occupied by a single complication. If the smallImage is equal to SmallImage.PLACEHOLDER the renderer must treat it as a placeholder rather than rendering normally, its suggested it should be rendered as a light grey box.
getText
public final @NonNull ComplicationText getText()
The body ComplicationText of the complication. If the text is equal to ComplicationText.PLACEHOLDER the renderer must treat it as a placeholder rather than rendering normally, its suggested it should be rendered as a light grey box.
getTitle
public final ComplicationText getTitle()
The optional title ComplicationText. If the title is equal to ComplicationText.PLACEHOLDER the renderer must treat it as a placeholder rather than rendering normally, its suggested it should be rendered as a light grey box.
hasPlaceholderFields
public boolean hasPlaceholderFields()
Returns true if any of the fields of this ComplicationData are placeholders. I.e. if any fields are equal to: ComplicationText.PLACEHOLDER, SmallImage.PLACEHOLDER, MonochromaticImage.PLACEHOLDER, PhotoImageComplicationData.PLACEHOLDER, or RangedValueComplicationData.PLACEHOLDER.