Span (ofdrw-layout 2.3.4 API)

java.lang.Object
- org.ofdrw.layout.element.Span

所有已实现的接口:

TextFontInfo

直接已知子类:

PlaceholderSpan
```
public class Span
extends Object
implements TextFontInfo
```
字体基础单元
用来设置字体样式等

从以下版本开始:

2020-02-03 02:01:53

作者:

权观宇

构造器概要

构造器
限定符构造器和说明

protected Span()

Span(Font font, Double fontSize, String text)

Span(String text)

构造器
限定符	构造器和说明
`protected`	`Span()`
	`Span(Font font, Double fontSize, String text)`
	`Span(String text)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`Rectangle`	`blockSize()`
`Span`	`clone()`
`int[]`	`getColor()`
`Double[]`	`getDeltaX()` 获取字符X坐标偏移值队列队列中的每个值代表后一个文字与前一个文字之间在X方向上的偏移值
`Font`	`getFont()` 获取字体对象
`Double`	`getFontSize()` 获取文字字号
`Double`	`getLetterSpacing()` 获取字间距
`String`	`getText()`
`double`	`getUnderlineOffset()` 获取下划线与文字的偏移量
`double`	`getUnderlineWidth()` 获取下划线宽度
`org.ofdrw.core.text.text.Weight`	`getWeight()` 获取字体粗细
`List<TxtGlyph>`	`glyphList()` 获取字体图形列表
`boolean`	`hasLinebreak()` 是否是一个占满剩余行空间的Span
`boolean`	`isBold()`
`Boolean`	`isFill()`
`Boolean`	`isIntegrity()` 元素是否可以拆分特殊的：如果没有或只有一个文字，那么无论如何设置integrity都为不可拆分
`boolean`	`isItalic()`
`boolean`	`isUnderline()`
`int`	`length()`
`Span`	`setBold(boolean bold)` 设置是否加粗若需要更加细致的控制，可以使用 `setWeight(Weight)`
`Span`	`setColor(int[] rgb)` 设置字体颜色
`Span`	`setColor(int r, int g, int b)` 设置字体颜色
`Span`	`setColor(String color)` 设置文字颜色
`Span`	`setFill(boolean fill)`
`Span`	`setFont(Font font)`
`Span`	`setFontSize(Double fontSize)`
`Span`	`setIntegrity(Boolean integrity)`
`Span`	`setItalic(boolean italic)`
`Span`	`setLetterSpacing(Double letterSpacing)`
`Span`	`setLinebreak(boolean linebreak)` 设置Span为占满剩下行空间的元素等价于在字符串末尾增加\n，当字符串末尾存在\n 时该参数无效。
`Span`	`setText(String text)`
`Span`	`setUnderline(boolean underline)` 设置下划线
`Span`	`setUnderline(boolean underline, double offset, double width)` 设置下划线
`Span`	`setWeight(org.ofdrw.core.text.text.Weight weight)` 设置字体粗细
`Span[]`	`split(int index)` 切分元素
`LinkedList<Span>`	`splitLineBreak()` 获取经过行内换行处理之后的Span列表

从类继承的方法 java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Span
```
protected Span()
```
  - Span
```
public Span(Font font,
            Double fontSize,
            String text)
```
  - Span
```
public Span(String text)
```
- 方法详细资料
  - getColor
```
public int[] getColor()
```
  - setColor
```
public Span setColor(int[] rgb)
```
    设置字体颜色
    
    参数:
    
    rgb - 颜色值
    
    返回:
    
    this
  - setColor
```
public Span setColor(String color)
```
    设置文字颜色
    
    参数:
    
    color - 颜色值，可以是 16进制值 "#FFFFFF"、 16进制值缩写 "#FF"F、RGB "rgb(255,255,255)"、颜色名称 "white"
    
    返回:
    
    this
  - setColor
```
public Span setColor(int r,
                     int g,
                     int b)
```
    设置字体颜色
    
    参数:
    
    r - 红
    
    g - 绿
    
    b - 懒
    
    返回:
    
    this
  - length
```
public int length()
```
    返回:
    
    字符数量
  - getFont
```
public Font getFont()
```
    从接口复制的说明: TextFontInfo
    
    获取字体对象
    
    指定者:
    
    getFont 在接口中 TextFontInfo
    
    返回:
    
    字体对象
  - setFont
```
public Span setFont(Font font)
```
  - getFontSize
```
public Double getFontSize()
```
    从接口复制的说明: TextFontInfo
    
    获取文字字号
    
    指定者:
    
    getFontSize 在接口中 TextFontInfo
    
    返回:
    
    字号，单位毫米mm
  - setFontSize
```
public Span setFontSize(Double fontSize)
```
  - getLetterSpacing
```
public Double getLetterSpacing()
```
    从接口复制的说明: TextFontInfo
    
    获取字间距
    
    指定者:
    
    getLetterSpacing 在接口中 TextFontInfo
    
    返回:
    
    字间距，单位毫米mm
  - setLetterSpacing
```
public Span setLetterSpacing(Double letterSpacing)
```
  - isBold
```
public boolean isBold()
```
  - setBold
```
public Span setBold(boolean bold)
```
    设置是否加粗
    若需要更加细致的控制，可以使用 setWeight(Weight)
    
    参数:
    
    bold - 是否加粗
    
    返回:
    
    this
  - getWeight
```
public org.ofdrw.core.text.text.Weight getWeight()
```
    获取字体粗细
    
    返回:
    
    字体粗细，可能为null。
  - setWeight
```
public Span setWeight(org.ofdrw.core.text.text.Weight weight)
```
    设置字体粗细
    
    参数:
    
    weight - 字体粗细
    
    返回:
    
    this
  - isItalic
```
public boolean isItalic()
```
  - setItalic
```
public Span setItalic(boolean italic)
```
  - isUnderline
```
public boolean isUnderline()
```
  - setUnderline
```
public Span setUnderline(boolean underline)
```
    设置下划线
    
    参数:
    
    underline - 是否启用下划线
    
    返回:
    
    this
  - setUnderline
```
public Span setUnderline(boolean underline,
                         double offset,
                         double width)
```
    设置下划线
    
    参数:
    
    underline - 是否启用下划线
    
    offset - 下划线与文字的偏移量，可以为负值，默认值为1.2，单位毫米。
    
    width - 下划线线宽，默认为0，为0时默认为字体大小的0.05倍。
    
    返回:
    
    this
  - isFill
```
public Boolean isFill()
```
  - setFill
```
public Span setFill(boolean fill)
```
  - getText
```
public String getText()
```
  - setText
```
public Span setText(String text)
```
  - isIntegrity
```
public Boolean isIntegrity()
```
    元素是否可以拆分
    特殊的：如果没有或只有一个文字，那么无论如何设置integrity都为不可拆分
    
    返回:
    
    true 可以拆分；false 不能拆分
  - setIntegrity
```
public Span setIntegrity(Boolean integrity)
```
  - glyphList
```
public List<TxtGlyph> glyphList()
```
    获取字体图形列表
    
    返回:
    
    字体图形列表
  - getDeltaX
```
public Double[] getDeltaX()
```
    获取字符X坐标偏移值队列
    队列中的每个值代表后一个文字与前一个文字之间在X方向上的偏移值
    
    返回:
    
    字符在X坐标偏移值队列
  - blockSize
```
public Rectangle blockSize()
```
    返回:
    
    不拆分情况下都放在一行内占用的大小
  - split
```
public Span[] split(int index)
```
    切分元素
    
    参数:
    
    index - 字符坐标
    
    返回:
    
    切分后的两个全新元素
  - setLinebreak
```
public Span setLinebreak(boolean linebreak)
```
    设置Span为占满剩下行空间的元素
    等价于在字符串末尾增加\n，当字符串末尾存在\n 时该参数无效。
    
    参数:
    
    linebreak - 是否占满剩下行空间 true 标识占满；false标识不占满
    
    返回:
    
    this
  - hasLinebreak
```
public boolean hasLinebreak()
```
    是否是一个占满剩余行空间的Span
    
    返回:
    
    true 标识span会占满剩余的行空间； false 不占满
  - splitLineBreak
```
public LinkedList<Span> splitLineBreak()
```
    获取经过行内换行处理之后的Span列表
    
    返回:
    
    带有占满行剩余内容的Span序列
  - getUnderlineOffset
```
public double getUnderlineOffset()
```
    获取下划线与文字的偏移量
    
    返回:
    
    下划线与文字的偏移量，单位毫米
  - getUnderlineWidth
```
public double getUnderlineWidth()
```
    获取下划线宽度
    
    返回:
    
    下划线宽度, 0表示保持默认，默认为字体大小的0.05倍，单位毫米
  - clone
```
public Span clone()
```
    覆盖:
    
    clone 在类中 Object

类 Span

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Span

Span

Span

方法详细资料

getColor

setColor

setColor

setColor

length

getFont

setFont

getFontSize

setFontSize

getLetterSpacing

setLetterSpacing

isBold

setBold

getWeight

setWeight

isItalic

setItalic

isUnderline

setUnderline

setUnderline

isFill

setFill

getText

setText

isIntegrity

setIntegrity

glyphList

getDeltaX

blockSize

split

setLinebreak

hasLinebreak

splitLineBreak

getUnderlineOffset

getUnderlineWidth

clone