BulletSpan
open class BulletSpan : LeadingMarginSpan, ParcelableSpan
| kotlin.Any | |
| ↳ | android.text.style.BulletSpan | 
A span which styles paragraphs as bullet points (respecting layout direction).
BulletSpans must be attached from the first character to the last character of a single paragraph, otherwise the bullet point will not be displayed but the first paragraph encountered will have a leading margin.
BulletSpans allow configuring the following elements:
- gap width - the distance, in pixels, between the bullet point and the paragraph. Default value is 2px.
- color - the bullet point color. By default, the bullet point color is 0 - no color, so it uses the TextView's text color.
- bullet radius - the radius, in pixels, of the bullet point. Default value is 4px.
<code>SpannableString string = new SpannableString("Text with\nBullet point"); string.setSpan(new BulletSpan(), 10, 22, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);</code>
To construct a BulletSpan with a gap width of 40px, green bullet point and bullet radius of 20px:
<code>SpannableString string = new SpannableString("Text with\nBullet point"); string.setSpan(new BulletSpan(40, color, 20), 10, 22, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);</code>
Summary
| Constants | |
|---|---|
| static Int | |
| Public constructors | |
|---|---|
| Creates a  | |
| BulletSpan(src: Parcel)Creates a  | |
| BulletSpan(gapWidth: Int)Creates a  | |
| BulletSpan(gapWidth: Int, color: Int)Creates a  | |
| BulletSpan(gapWidth: Int, color: Int, bulletRadius: Int)Creates a  | |
| Public methods | |
|---|---|
| open Int | |
| open Unit | drawLeadingMargin(canvas: Canvas, paint: Paint, x: Int, dir: Int, top: Int, baseline: Int, bottom: Int, text: CharSequence, start: Int, end: Int, first: Boolean, layout: Layout?)Renders the leading margin. | 
| open Int | Get the radius, in pixels, of the bullet point. | 
| open Int | getColor()Get the bullet point color. | 
| open Int | Get the distance, in pixels, between the bullet point and the paragraph. | 
| open Int | getLeadingMargin(first: Boolean) | 
| open Int | |
| open String | toString() | 
| open Unit | writeToParcel(dest: Parcel, flags: Int)Flatten this object in to a Parcel. | 
Constants
Public constructors
BulletSpan
BulletSpan(src: Parcel)
Creates a BulletSpan from a parcel.
| Parameters | |
|---|---|
| src | Parcel: This value cannot be null. | 
BulletSpan
BulletSpan(gapWidth: Int)
Creates a BulletSpan based on a gap width
| Parameters | |
|---|---|
| gapWidth | Int: the distance, in pixels, between the bullet point and the paragraph. | 
BulletSpan
BulletSpan(
gapWidth: Int,
color: Int)
Creates a BulletSpan based on a gap width and a color integer.
| Parameters | |
|---|---|
| gapWidth | Int: the distance, in pixels, between the bullet point and the paragraph. | 
| color | Int: the bullet point color, as a color integer | 
See Also
BulletSpan
BulletSpan(
gapWidth: Int,
color: Int,
bulletRadius: Int)
Creates a BulletSpan based on a gap width and a color integer.
| Parameters | |
|---|---|
| gapWidth | Int: the distance, in pixels, between the bullet point and the paragraph. | 
| color | Int: the bullet point color, as a color integer. | 
| bulletRadius | Int: the radius of the bullet point, in pixels. Value is 0 or greater | 
See Also
Public methods
describeContents
open fun describeContents(): Int
| Return | |
|---|---|
| Int | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0orandroid.os.Parcelable#CONTENTS_FILE_DESCRIPTOR | 
drawLeadingMargin
open fun drawLeadingMargin(
canvas: Canvas,
paint: Paint,
x: Int,
dir: Int,
top: Int,
baseline: Int,
bottom: Int,
text: CharSequence,
start: Int,
end: Int,
first: Boolean,
layout: Layout?
): Unit
Renders the leading margin. This is called before the margin has been adjusted by the value returned by getLeadingMargin(boolean).
| Parameters | |
|---|---|
| c | the canvas | 
| p | the paint. The this should be left unchanged on exit. | 
| x | Int: the current position of the margin | 
| dir | Int: the base direction of the paragraph; if negative, the margin is to the right of the text, otherwise it is to the left. | 
| top | Int: the top of the line | 
| baseline | Int: the baseline of the line | 
| bottom | Int: the bottom of the line | 
| text | CharSequence: This value cannot be null. | 
| start | Int: the start of the line | 
| end | Int: the end of the line | 
| first | Boolean: true if this is the first line of its paragraph | 
| layout | Layout?: This value may be null. | 
| canvas | Canvas: This value cannot be null. | 
| paint | Paint: This value cannot be null. | 
getBulletRadius
open fun getBulletRadius(): Int
Get the radius, in pixels, of the bullet point.
| Return | |
|---|---|
| Int | the radius, in pixels, of the bullet point. | 
getColor
open fun getColor(): Int
Get the bullet point color.
| Return | |
|---|---|
| Int | the bullet point color | 
getGapWidth
open fun getGapWidth(): Int
Get the distance, in pixels, between the bullet point and the paragraph.
| Return | |
|---|---|
| Int | the distance, in pixels, between the bullet point and the paragraph. | 
getLeadingMargin
open fun getLeadingMargin(first: Boolean): Int
| Parameters | |
|---|---|
| first | Boolean: true if the request is for the first line of a paragraph, false for subsequent lines | 
| Return | |
|---|---|
| Int | the offset for the margin. | 
toString
open fun toString(): String
| Return | |
|---|---|
| String | a string representation of the object. | 
writeToParcel
open fun writeToParcel(
dest: Parcel,
flags: Int
): Unit
Flatten this object in to a Parcel.
| Parameters | |
|---|---|
| dest | Parcel: This value cannot be null. | 
| flags | Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either0or a combination ofandroid.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES | 
