Added in API level 28

TextLinks

Kotlin |Java

public final class TextLinks
extends Object implements Parcelable

java.lang.Object
↳	android.view.textclassifier.TextLinks

A collection of links, representing subsequences of text and the entity types (phone number, address, url, etc) they may be.

Summary

Nested classes
`class`	`TextLinks.Builder` A builder to construct a TextLinks instance.
`class`	`TextLinks.Request` A request object for generating TextLinks.
`class`	`TextLinks.TextLink` A link, identifying a substring of text and possible entity types for it.
`class`	`TextLinks.TextLinkSpan` A ClickableSpan for a TextLink.

Constants
`int`	`APPLY_STRATEGY_IGNORE` Do not replace `ClickableSpan`s that exist where the `TextLinkSpan` needs to be applied to.
`int`	`APPLY_STRATEGY_REPLACE` Replace any `ClickableSpan`s that exist where the `TextLinkSpan` needs to be applied to.
`int`	`STATUS_DIFFERENT_TEXT` The specified text does not match the text used to generate the links.
`int`	`STATUS_LINKS_APPLIED` Links were successfully applied to the text.
`int`	`STATUS_NO_LINKS_APPLIED` No links applied to text.
`int`	`STATUS_NO_LINKS_FOUND` No links exist to apply to text.
`int`	`STATUS_UNSUPPORTED_CHARACTER` The specified text contains unsupported characters.

Inherited constants

From interface android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` Descriptor bit used with `describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Flag for use with `writeToParcel(Parcel, int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

Fields
`public static final Creator<TextLinks>`	`CREATOR`

Public methods
`int`	`apply(Spannable text, int applyStrategy, Function<TextLinks.TextLink, TextLinks.TextLinkSpan> spanFactory)` Annotates the given text with the generated links.
`int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`Bundle`	`getExtras()` Returns the extended data.
`Collection<TextLinks.TextLink>`	`getLinks()` Returns an unmodifiable Collection of the links.
`CharSequence`	`getText()` Returns the text that was used to generate these links.
`String`	`toString()` Returns a string representation of the object.
`void`	`writeToParcel(Parcel dest, int flags)` Flatten this object in to a Parcel.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface


        
          android.os.Parcelable

`abstract int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Flatten this object in to a Parcel.

Constants

APPLY_STRATEGY_IGNORE

Added in API level 28

public static final int APPLY_STRATEGY_IGNORE

Do not replace ClickableSpans that exist where the TextLinkSpan needs to be applied to. Do not apply the TextLinkSpan.

Constant Value: 0 (0x00000000)

APPLY_STRATEGY_REPLACE

Added in API level 28

public static final int APPLY_STRATEGY_REPLACE

Replace any ClickableSpans that exist where the TextLinkSpan needs to be applied to.

Constant Value: 1 (0x00000001)

STATUS_DIFFERENT_TEXT

Added in API level 28

public static final int STATUS_DIFFERENT_TEXT

The specified text does not match the text used to generate the links.

Constant Value: 3 (0x00000003)

STATUS_LINKS_APPLIED

Added in API level 28

public static final int STATUS_LINKS_APPLIED

Links were successfully applied to the text.

Constant Value: 0 (0x00000000)

STATUS_NO_LINKS_APPLIED

Added in API level 28

public static final int STATUS_NO_LINKS_APPLIED

No links applied to text. The links were filtered out.

Constant Value: 2 (0x00000002)

STATUS_NO_LINKS_FOUND

Added in API level 28

public static final int STATUS_NO_LINKS_FOUND

No links exist to apply to text. Links count is zero.

Constant Value: 1 (0x00000001)

STATUS_UNSUPPORTED_CHARACTER

Added in API level 29

public static final int STATUS_UNSUPPORTED_CHARACTER

The specified text contains unsupported characters.

Constant Value: 4 (0x00000004)

Fields

CREATOR

Added in API level 28

public static final Creator<TextLinks> CREATOR

Public methods

apply

Added in API level 28

public int apply (Spannable text, 
                int applyStrategy, 
                Function<TextLinks.TextLink, TextLinks.TextLinkSpan> spanFactory)

Annotates the given text with the generated links. It will fail if the provided text doesn't match the original text used to create the TextLinks.

NOTE: It may be necessary to set a LinkMovementMethod on the TextView widget to properly handle links. See TextView.setMovementMethod(MovementMethod)

Parameters
`text`	`Spannable`: the text to apply the links to. Must match the original text This value cannot be `null`.
`applyStrategy`	`int`: the apply strategy used to determine how to apply links to text. e.g `TextLinks.APPLY_STRATEGY_IGNORE` Value is `APPLY_STRATEGY_IGNORE`, or `APPLY_STRATEGY_REPLACE`
`spanFactory`	`Function`: a custom span factory for converting TextLinks to TextLinkSpans. Set to `null` to use the default span factory.

Returns
`int`	a status code indicating whether or not the links were successfully applied e.g. `STATUS_LINKS_APPLIED` Value is `STATUS_LINKS_APPLIED`, `STATUS_NO_LINKS_FOUND`, `STATUS_NO_LINKS_APPLIED`, `STATUS_DIFFERENT_TEXT`, or `STATUS_UNSUPPORTED_CHARACTER`

describeContents

Added in API level 28

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
`int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or `CONTENTS_FILE_DESCRIPTOR`

getExtras

Added in API level 29

public Bundle getExtras ()

Returns the extended data.

NOTE: Do not modify this bundle.

Returns
`Bundle`	This value cannot be `null`.

getLinks

Added in API level 28

public Collection<TextLinks.TextLink> getLinks ()

Returns an unmodifiable Collection of the links.

Returns
`Collection<TextLinks.TextLink>`	This value cannot be `null`.

getText

Added in API level 30

public CharSequence getText ()

Returns the text that was used to generate these links.

Returns
`CharSequence`	This value cannot be `null`.

toString

Added in API level 28

public String toString ()

Returns a string representation of the object.

Returns
`String`	a string representation of the object.

writeToParcel

Added in API level 28

public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
`dest`	`Parcel`: The Parcel in which the object should be written. This value cannot be `null`.
`flags`	`int`: Additional flags about how the object should be written. May be 0 or `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

TextLinks

Summary

Nested classes

Constants

Inherited constants

Fields

Public methods

Inherited methods

Constants

APPLY_STRATEGY_IGNORE

APPLY_STRATEGY_REPLACE

STATUS_DIFFERENT_TEXT

STATUS_LINKS_APPLIED

STATUS_NO_LINKS_APPLIED

STATUS_NO_LINKS_FOUND

STATUS_UNSUPPORTED_CHARACTER

Fields

CREATOR

Public methods

apply

describeContents

getExtras

getLinks

getText

toString

writeToParcel