Summary: Constants | Methods | Inherited Methods

CarIconSpan

public class CarIconSpan
extends CharacterStyle

java.lang.Object
↳	android.text.style.CharacterStyle
	↳	com.google.android.libraries.car.app.model.CarIconSpan

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(CarIcon.of(
         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
`int`	`ALIGN_BASELINE` A constant indicating that the bottom of this span should be aligned with the baseline of the surrounding text.
`int`	`ALIGN_BOTTOM` 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.
`int`	`ALIGN_CENTER` A constant indicating that this span should be vertically centered between the top and the lowest descender.

Public methods
`static CarIconSpan`	`create(CarIcon icon)` Creates a `CarIconSpan` from a `CarIcon` with a default alignment of `ALIGN_BASELINE`.
`static CarIconSpan`	`create(CarIcon icon, int alignment)` Creates a `CarIconSpan` from a `CarIcon`, specifying the alignment of the icon with respect to its surrounding text.
`boolean`	`equals(Object other)`
`int`	`hashCode()`
`String`	`toString()`
`void`	`updateDrawState(TextPaint paint)`

Inherited methods

From class


        
          android.text.style.CharacterStyle

`CharacterStyle`	`getUnderlying()`
`abstract void`	`updateDrawState(TextPaint arg0)`
`static CharacterStyle`	`wrap(CharacterStyle arg0)`

From class


        
          java.lang.Object

`Object`	`clone()`
`boolean`	`equals(Object arg0)`
`void`	`finalize()`
`final Class<?>`	`getClass()`
`int`	`hashCode()`
`final void`	`notify()`
`final void`	`notifyAll()`
`String`	`toString()`
`final void`	`wait(long arg0, int arg1)`
`final void`	`wait(long arg0)`
`final void`	`wait()`

Constants

ALIGN_BASELINE

public static final int ALIGN_BASELINE

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

Constant Value: 1 (0x00000001)

ALIGN_BOTTOM

public static final int ALIGN_BOTTOM

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.

Constant Value: 0 (0x00000000)

ALIGN_CENTER

public static final int ALIGN_CENTER

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

Constant Value: 2 (0x00000002)

Public methods

create

public static CarIconSpan create (CarIcon icon)

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

Parameters
`icon`	`CarIcon`

Returns
`CarIconSpan`

Throws
`NullPointerException`	if `icon` is `null`.

See also:

create(CarIcon, int)

create

public static CarIconSpan create (CarIcon icon, 
                int alignment)

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

Parameters
`icon`	`CarIcon`: the `CarIcon` to replace the text with.
`alignment`	`int`: the alignment of the `CarIcon` relative to the text. This should be one of `ALIGN_BASELINE`, `ALIGN_BOTTOM` or `ALIGN_CENTER`.

Returns
`CarIconSpan`

Throws
`NullPointerException`	if `icon` is `null`.
`IllegalArgumentException`	if `alignment` is not a valid value.

See also:

equals

public boolean equals (Object other)

Parameters
`other`	`Object`

Returns
`boolean`

hashCode

public int hashCode ()

Returns
`int`

toString

public String toString ()

Returns
`String`

updateDrawState

public void updateDrawState (TextPaint paint)

Parameters
`paint`	`TextPaint`