CarIconSpan

@CarProtocol
public final class CarIconSpan extends CarSpan


A span that replaces the text it is attached to with a CarIcon that is aligned with the surrounding text.

The image may be scaled with the text differently depending on the template that the text belongs to. Refer to the documentation of each template for that information.

For example, the following code creates a string for a navigation maneuver that has an image with the number of a highway rendered as an icon in between "on" and "East":

SpannableString string = new SpannableString("Turn right on 520 East");
string.setSpan(
    CarIconSpan.create(new CarIcon.Builder(
        IconCompat.createWithResource(getCarContext(), R.drawable.ic_520_highway))),
        14, 17, SPAN_INCLUSIVE_EXCLUSIVE);

CarIconSpans in strings passed to the library templates may be ignored by the host when displaying the text unless support for them is explicitly documented in the API that takes the string.

This span will be ignored if it overlaps with any span that replaces text, such as another DistanceSpan, DurationSpan, or CarIconSpan.

See also
CarIcon

Summary

Constants

static final int

A constant indicating that the bottom of this span should be aligned with the baseline of the surrounding text.

static final int

A constant indicating that the bottom of this span should be aligned with the bottom of the surrounding text, at the same level as the lowest descender in the text.

static final int

A constant indicating that this span should be vertically centered between the top and the lowest descender.

Public methods

static @NonNull CarIconSpan

Creates a CarIconSpan from a CarIcon with a default alignment of ALIGN_BASELINE.

static @NonNull CarIconSpan
create(@NonNull CarIcon icon, int alignment)

Creates a CarIconSpan from a CarIcon, specifying the alignment of the icon with respect to its surrounding text.

boolean
int

Returns the alignment that should be used with this span.

@NonNull CarIcon

Returns the CarIcon instance associated with this span.

int
@NonNull String

Constants

ALIGN_BASELINE

Added in 1.0.0
public static final int ALIGN_BASELINE = 1

A constant indicating that the bottom of this span should be aligned with the baseline of the surrounding text.

ALIGN_BOTTOM

Added in 1.0.0
public static final int ALIGN_BOTTOM = 0

A constant indicating that the bottom of this span should be aligned with the bottom of the surrounding text, at the same level as the lowest descender in the text.

ALIGN_CENTER

Added in 1.0.0
public static final int ALIGN_CENTER = 2

A constant indicating that this span should be vertically centered between the top and the lowest descender.

Public methods

create

Added in 1.0.0
public static @NonNull CarIconSpan create(@NonNull CarIcon icon)

Creates a CarIconSpan from a CarIcon with a default alignment of ALIGN_BASELINE.

Throws
java.lang.NullPointerException

if icon is null

See also
create

create

Added in 1.0.0
public static @NonNull CarIconSpan create(@NonNull CarIcon icon, int alignment)

Creates a CarIconSpan from a CarIcon, specifying the alignment of the icon with respect to its surrounding text.

Parameters
@NonNull CarIcon icon

the CarIcon to replace the text with

int alignment

the alignment of the CarIcon relative to the text. This should be one of ALIGN_BASELINE, ALIGN_BOTTOM or ALIGN_CENTER

Throws
java.lang.NullPointerException

if icon is null

java.lang.IllegalArgumentException

if alignment is not a valid value

equals

Added in 1.4.0-rc02
public boolean equals(@Nullable Object other)

getAlignment

Added in 1.0.0
public int getAlignment()

Returns the alignment that should be used with this span.

getIcon

Added in 1.0.0
public @NonNull CarIcon getIcon()

Returns the CarIcon instance associated with this span.

hashCode

Added in 1.4.0-rc02
public int hashCode()

toString

Added in 1.4.0-rc02
public @NonNull String toString()