CharacterStyle

Kotlin |Java

abstract class CharacterStyle

kotlin.Any
↳	android.text.style.CharacterStyle

Known Direct Subclasses

BackgroundColorSpan, ClickableSpan, ForegroundColorSpan, MaskFilterSpan, MetricAffectingSpan, StrikethroughSpan, SuggestionRangeSpan, SuggestionSpan, UnderlineSpan

BackgroundColorSpan	Changes the background color of the text to which the span is attached.
ClickableSpan	If an object of this type is attached to the text of a TextView with a movement method of LinkMovementMethod, the affected spans of text can be selected.
ForegroundColorSpan	Changes the color of the text to which the span is attached.
MaskFilterSpan	Span that allows setting a `MaskFilter` to the text it's attached to.
MetricAffectingSpan	The classes that affect character-level text formatting in a way that changes the width or height of characters extend this class.
StrikethroughSpan	A span that strikes through the text it's attached to.
SuggestionRangeSpan	A SuggestionRangeSpan is used to show which part of an EditText is affected by a suggestion popup window.
SuggestionSpan	Holds suggestion candidates for the text enclosed in this span.
UnderlineSpan	A span that underlines the text it's attached to.

Known Indirect Subclasses

AbsoluteSizeSpan, DynamicDrawableSpan, ImageSpan, LocaleSpan, RelativeSizeSpan, ReplacementSpan, ScaleXSpan, StyleSpan, SubscriptSpan, SuperscriptSpan, TextAppearanceSpan, TextLinks.TextLinkSpan, and 2 others.

AbsoluteSizeSpan	A span that changes the size of the text it's attached to.
DynamicDrawableSpan	Span that replaces the text it's attached to with a `Drawable` that can be aligned with the bottom or with the baseline of the surrounding text.
ImageSpan	Span that replaces the text it's attached to with a `Drawable` that can be aligned with the bottom or with the baseline of the surrounding text.
LocaleSpan	Changes the `Locale` of the text to which the span is attached.
RelativeSizeSpan	Uniformly scales the size of the text to which it's attached by a certain proportion.
ReplacementSpan
ScaleXSpan	Scales horizontally the size of the text to which it's attached by a certain factor.
StyleSpan	Span that allows setting the style of the text it's attached to.
SubscriptSpan	The span that moves the position of the text baseline lower.
SuperscriptSpan	The span that moves the position of the text baseline higher.
TextAppearanceSpan	Sets the text appearance using the given `TextAppearance` attributes.
TextLinks.TextLinkSpan	A ClickableSpan for a TextLink.
TypefaceSpan	Span that updates the typeface of the text it's attached to.
URLSpan	Implementation of the `ClickableSpan` that allows setting a url string.

The classes that affect character-level text formatting extend this class. Most extend its subclass MetricAffectingSpan, but simple ones may just implement UpdateAppearance.

Summary

Public constructors
`CharacterStyle()`

Public methods
open CharacterStyle!	`getUnderlying()` Returns "this" for most CharacterStyles, but for CharacterStyles that were generated by `wrap`, returns the underlying CharacterStyle.
abstract Unit	`updateDrawState(tp: TextPaint!)`
open static CharacterStyle!	`wrap(cs: CharacterStyle!)` A given CharacterStyle can only applied to a single region of a given Spanned.

Public constructors

CharacterStyle

CharacterStyle()

Public methods

getUnderlying

Added in API level 1

open fun getUnderlying(): CharacterStyle!

Returns "this" for most CharacterStyles, but for CharacterStyles that were generated by wrap, returns the underlying CharacterStyle.

updateDrawState

Added in API level 1

abstract fun updateDrawState(tp: TextPaint!): Unit

wrap

Added in API level 1

open static fun wrap(cs: CharacterStyle!): CharacterStyle!

A given CharacterStyle can only applied to a single region of a given Spanned. If you need to attach the same CharacterStyle to multiple regions, you can use this method to wrap it with a new object that will have the same effect but be a distinct object so that it can also be attached without conflict.