A stylized text string used to represent cell text. Substrings of the text can have different text styles.
A run
is the longest unbroken substring having the same text style. For example, the
sentence, "This child
is carrying
apples" has 4 runs: ['This ', 'child ',
'is carrying ', 'apples']
.
Methods
| Method | Return type | Brief description |
|---|---|---|
Rich
|
Returns a builder for a Rich Text value initialized with the values of this Rich Text value. | |
Integer
|
Gets the end index of this value in the cell. | |
String
|
Returns the link URL for this value. | |
String
|
Returns the link URL for the text from start
to end
. |
|
Rich
|
Returns the Rich Text string split into an array of runs, wherein each run is the longest possible substring having a consistent text style. | |
Integer
|
Gets the start index of this value in the cell. | |
String
|
Returns the text of this value. | |
Text
|
Returns the text style of this value. | |
Text
|
Returns the text style of the text from start
to end
. |
Detailed documentation
copy()
Returns a builder for a Rich Text value initialized with the values of this Rich Text value.
Return
Rich
— A builder for a Rich Text value.
get
End
Index()
Gets the end index of this value in the cell.
Return
Integer
— The end index of this value in the cell.
get
Link
Url()
Returns the link URL for this value.
Return
String
— The link URL for this value, or null
if there is no link or if there are
multiple different links.
get
Link
Url(startOffset, endOffset)
Returns the link URL for the text from start
to end
. Offsets are 0
based and relative to the cell's text, with the start offset being inclusive and the end offset
being exclusive.
Parameters
| Name | Type |
|---|---|
start
|
Integer
|
Description : The start offset. | |
end
|
Integer
|
Description : The end offset. | |
Return
String
— The link URL for this value, or null
if there is no link or if multiple
different links are in the given range.
get
Runs()
Returns the Rich Text string split into an array of runs, wherein each run is the longest possible substring having a consistent text style.
Return
Rich
— An array of runs.
get
Start
Index()
Gets the start index of this value in the cell.
Return
Integer
— The start index of this value in the cell.
get
Text()
Returns the text of this value.
Return
String
— The text of this value.
get
Text
Style()
get
Text
Style(startOffset, endOffset)
Returns the text style of the text from start
to end
. Offsets are 0
based and relative to the cell's text, with the start offset being inclusive and the end offset
being exclusive.
Parameters
| Name | Type |
|---|---|
start
|
Integer
|
Description : The start offset. | |
end
|
Integer
|
Description : The end offset. | |
Return
Text
— The text style of the given substring of this value.
