DurationSpan
@CarProtocol
public final class DurationSpan extends CarSpan
| java.lang.Object | |||
| ↳ | android.text.style.CharacterStyle | ||
| ↳ | androidx.car.app.model.CarSpan | ||
| ↳ | androidx.car.app.model.DurationSpan | ||
A span that replaces the text it is attached to with a localized duration string.
For example, the following code creates a string that shows the duration as the first text in the string before the interpunct:
String interpunct = "\\u00b7";
SpannableString string = new SpannableString(" " + interpunct + " Point-of-Interest 1");
string.setSpan(DurationSpan.create(300), 0, 1, SPAN_INCLUSIVE_INCLUSIVE);The span flags (e.g. SPAN_EXCLUSIVE_EXCLUSIVE) will be ignored.
This span will be ignored if it overlaps with any span that replaces text, such as another DistanceSpan, DurationSpan, or CarIconSpan. However, it is possible to * apply styling to the text, such as changing colors:
String interpunct = "\\u00b7"; SpannableString string = new SpannableString(" " + interpunct + " Point-of-Interest 1"); string.setSpan(DurationSpan.create(300), 0, 1, SPAN_INCLUSIVE_INCLUSIVE); string.setSpan(ForegroundCarColorSpan.create(CarColor.BLUE), 0, 1, SPAN_EXCLUSIVE_EXCLUSIVE);
Summary
Public methods |
|
|---|---|
static @NonNull DurationSpan |
@RequiresApi(value = 26)Creates a |
static @NonNull DurationSpan |
create(long durationSeconds)Creates a |
boolean |
|
long |
Returns the time duration associated with this span, in seconds. |
int |
hashCode() |
@NonNull String |
toString() |
Inherited methods |
||||||
|---|---|---|---|---|---|---|
|
||||||
|
Public methods
create
@RequiresApi(value = 26)
public static @NonNull DurationSpan create(@NonNull Duration duration)
Creates a DurationSpan with the given duration.
create
public static @NonNull DurationSpan create(long durationSeconds)
Creates a DurationSpan with the given duration.
getDurationSeconds
public long getDurationSeconds()
Returns the time duration associated with this span, in seconds.