Paragraph (ofdrw-layout 2.3.4 API)

java.lang.Object
- org.ofdrw.layout.element.Div<Paragraph>
- - org.ofdrw.layout.element.Paragraph

所有已实现的接口:

ElementSplit, RenderPrepare
```
public class Paragraph
extends Div<Paragraph>
```
段落
绘制行为详见渲染器：ParagraphRender

从以下版本开始:

2020-02-03 01:27:20

作者:

权观宇

构造器概要

构造器
构造器和说明
`Paragraph()` 创建一个段落对象注意如果不主动对 Paragraph 设置宽度，那么Paragraph 会独占整个段，并且与段具有相同宽度，也就是页面宽度，在需要更加细致盒式的布局时请设置`Div.setClear(Clear)` 并设置段落宽度 `Div.setWidth(Double)`。
`Paragraph(Double width, Double height)` 创建一个固定大小段落对象
`Paragraph(double x, double y, double width, double height)` 创建绝对定位段落对象
`Paragraph(double x, double y, double width, double height, String text, double fontSize)` 创建绝对定位段落对象
`Paragraph(String text)` 新建一个段落对象如果在指定段落中文字大小建议使用`Paragraph(java.lang.String, java.lang.Double)`
`Paragraph(String text, Double defaultFontSize)` 新建一个段落对象，并指定文字大小
`Paragraph(String text, Double defaultFontSize, Font defaultFont)` 新建一个段落对象，并指定文字大小和字体
`Paragraph(String text, Font defaultFont)` 新建一个段落对象，并指定字体

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`Paragraph`	`add(Span content)` 加入带有特殊样式文字内容
`Paragraph`	`add(String text)` 增加段落中的文字文字样式使用span默认字体样式
`Paragraph`	`clearFirstLineIndent()` 清除缩进格式
`Paragraph`	`clone()` 请勿调用该方法克隆段落，除非你知道你在干什么
`<T extends Div> Div[]`	`contentSplitAdjust(double sHeight, T div1, T div2)` 内容分割调整根据分割高度调整两个克隆元素，达成分割元素的效果
`Rectangle`	`doPrepare(Double widthLimit)` 预布局该方法主要有渲染器调用，请勿主动调用该方法，除非你知道你在做什么。
`String`	`elementType()` 元素类型关联渲染器：`ParagraphRender`
`LinkedList<Span>`	`getContents()`
`Font`	`getDefaultFont()`
`Integer`	`getFirstLineIndent()` 获取首行缩进字符数
`Double`	`getFirstLineIndentWidth()` 获取首行缩进数值该方法仅在已经设置了首行缩进数值的情况下才会返还正确的数值，否则返还null
`Double`	`getFontSize()`
`LinkedList<TxtLineBlock>`	`getLines()`
`Double`	`getLineSpace()`
`TextAlign`	`getTextAlign()` 获取段落内字体浮动默认为左浮动
`Paragraph`	`setContents(List<Span> contents)`
`Paragraph`	`setDefaultFont(Font defaultFont)`
`Paragraph`	`setDefaultFont(Font defaultFont, boolean refreshBeforeAdd)` 设置默认字体注意：在设置 defaultFont 之前被添加的内容，不会在调用 defaultFont 方法后而改变，除非指定 refreshBeforeAdd=true
`Paragraph`	`setFirstLineIndent(Integer firstLineIndent)` 设置段落首行缩进默认不缩进
`Paragraph`	`setFirstLineIndentWidth(double firstLineIndentWidth)` 设置段落首行缩进数值
`Paragraph`	`setFontSize(Double defaultFontSize)` 设置段落内默认的字体大小如果加入的文字没有设置大小，那么默认使用该值。
`Paragraph`	`setFontSize(Double defaultFontSize, boolean refreshBeforeAdd)` 设置段落内默认的字体大小如果加入的文字没有设置大小，那么默认使用该值。
`Paragraph`	`setLineSpace(Double lineSpace)`
`Paragraph`	`setTextAlign(TextAlign textAlign)` 设置段落内字体浮动默认为左浮动

从类继承的方法 org.ofdrw.layout.element.Div
box, copyTo, getBackgroundColor, getBorder, getBorderBottom, getBorderColor, getBorderDash, getBorderLeft, getBorderRight, getBorderTop, getClear, getDisplay, getFloat, getHeight, getLayer, getLeft, getMargin, getMarginBottom, getMarginLeft, getMarginRight, getMarginTop, getOnRenderFinish, getOpacity, getPadding, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getPosition, getRight, getTop, getWidth, getX, getY, heightPlus, isBlockElement, isIntegrity, isNoBorder, isPlaceholder, onRenderFinish, placeholder, placeholder, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBorder, setBorderBottom, setBorderColor, setBorderColor, setBorderColor, setBorderDash, setBorderLeft, setBorderRight, setBorderTop, setBox, setClear, setDisplay, setFloat, setHeight, setIntegrity, setLayer, setLeft, setMargin, setMarginBottom, setMarginLeft, setMarginRight, setMarginTop, setOpacity, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRight, setPaddingTop, setPlaceholder, setPosition, setRight, setTop, setWidth, setX, setXY, setY, split, toString, widthPlus

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

- 构造器详细资料
  - Paragraph
```
public Paragraph(Double width,
                 Double height)
```
    创建一个固定大小段落对象
    
    参数:
    
    width - 内容宽度
    
    height - 内容高度
  - Paragraph
```
public Paragraph()
```
    创建一个段落对象
    注意如果不主动对 Paragraph 设置宽度，那么Paragraph 会独占整个段，并且与段具有相同宽度，也就是页面宽度，在需要更加细致盒式的布局时请设置Div.setClear(Clear) 并设置段落宽度 Div.setWidth(Double)。
  - Paragraph
```
public Paragraph(double x,
                 double y,
                 double width,
                 double height)
```
    创建绝对定位段落对象
    
    参数:
    
    x - 固定布局的盒式模型左上角X坐标
    
    y - 固定布局的盒式模型左上角y坐标
    
    width - 宽度
    
    height - 高度
  - Paragraph
```
public Paragraph(double x,
                 double y,
                 double width,
                 double height,
                 String text,
                 double fontSize)
```
    创建绝对定位段落对象
    
    参数:
    
    x - 固定布局的盒式模型左上角X坐标
    
    y - 固定布局的盒式模型左上角y坐标
    
    width - 宽度
    
    height - 高度
    
    text - 文本内容
    
    fontSize - 字号
  - Paragraph
```
public Paragraph(String text)
```
    新建一个段落对象
    如果在指定段落中文字大小建议使用Paragraph(java.lang.String, java.lang.Double)
    
    参数:
    
    text - 文字内容
  - Paragraph
```
public Paragraph(String text,
                 Double defaultFontSize)
```
    新建一个段落对象，并指定文字大小
    
    参数:
    
    text - 文字内容
    
    defaultFontSize - 默认字体大小。
  - Paragraph
```
public Paragraph(String text,
                 Double defaultFontSize,
                 Font defaultFont)
```
    新建一个段落对象，并指定文字大小和字体
    
    参数:
    
    text - 文字内容
    
    defaultFontSize - 默认字体大小
    
    defaultFont - 默认字体
  - Paragraph
```
public Paragraph(String text,
                 Font defaultFont)
```
    新建一个段落对象，并指定字体
    
    参数:
    
    text - 文字内容
    
    defaultFont - 默认字体
- 方法详细资料
  - add
```
public Paragraph add(String text)
```
    增加段落中的文字
    文字样式使用span默认字体样式
    
    参数:
    
    text - 文本内容
    
    返回:
    
    this
  - add
```
public Paragraph add(Span content)
```
    加入带有特殊样式文字内容
    
    参数:
    
    content - 特殊样式文字内容
    
    返回:
    
    this
  - getLineSpace
```
public Double getLineSpace()
```
  - setLineSpace
```
public Paragraph setLineSpace(Double lineSpace)
```
  - getDefaultFont
```
public Font getDefaultFont()
```
  - setDefaultFont
```
public Paragraph setDefaultFont(Font defaultFont)
```
  - setDefaultFont
```
public Paragraph setDefaultFont(Font defaultFont,
                                boolean refreshBeforeAdd)
```
    设置默认字体
    注意：在设置 defaultFont 之前被添加的内容，不会在调用 defaultFont 方法后而改变，除非指定 refreshBeforeAdd=true
    
    参数:
    
    defaultFont - 默认字体
    
    refreshBeforeAdd - 是否对之前add的text内容应用这个字体
    
    返回:
    
    this
  - getFontSize
```
public Double getFontSize()
```
  - setFontSize
```
public Paragraph setFontSize(Double defaultFontSize)
```
    设置段落内默认的字体大小
    如果加入的文字没有设置大小，那么默认使用该值。
    注意：该操作不会对段落内已经存在的文字生效，因此在添加文字之后，在调用该方法，原有的文字大小不会变换。
    
    参数:
    
    defaultFontSize - 默认字体大小
    
    返回:
    
    this
  - setFontSize
```
public Paragraph setFontSize(Double defaultFontSize,
                             boolean refreshBeforeAdd)
```
    设置段落内默认的字体大小
    如果加入的文字没有设置大小，那么默认使用该值。
    注意：该操作不会对段落内已经存在的文字生效，因此在添加文字之后，在调用该方法，原有的文字大小不会变换。你可以指定 refreshBeforeAdd=true 来使之前添加的内容也生效。
    
    参数:
    
    defaultFontSize - 默认字体大小
    
    refreshBeforeAdd - 是否刷新之前添加的内容
    
    返回:
    
    this
  - getContents
```
public LinkedList<Span> getContents()
```
  - setContents
```
public Paragraph setContents(List<Span> contents)
```
  - getLines
```
public LinkedList<TxtLineBlock> getLines()
```
  - getFirstLineIndent
```
public Integer getFirstLineIndent()
```
    获取首行缩进字符数
    
    返回:
    
    首行缩进字符数 null表示没有缩进
  - setFirstLineIndent
```
public Paragraph setFirstLineIndent(Integer firstLineIndent)
```
    设置段落首行缩进
    默认不缩进
    
    参数:
    
    firstLineIndent - 缩进字符数null或0表示不缩进
    
    返回:
    
    this
  - getFirstLineIndentWidth
```
public Double getFirstLineIndentWidth()
```
    获取首行缩进数值
    该方法仅在已经设置了首行缩进数值的情况下才会返还正确的数值，否则返还null
    
    返回:
    
    首行缩进数值或null
  - setFirstLineIndentWidth
```
public Paragraph setFirstLineIndentWidth(double firstLineIndentWidth)
```
    设置段落首行缩进数值
    
    参数:
    
    firstLineIndentWidth - 首行缩进数值（单位：mm）
    
    返回:
    
    this
  - clearFirstLineIndent
```
public Paragraph clearFirstLineIndent()
```
    清除缩进格式
    
    返回:
    
    this
  - setTextAlign
```
public Paragraph setTextAlign(TextAlign textAlign)
```
    设置段落内字体浮动
    默认为左浮动
    
    参数:
    
    textAlign - 浮动方向
    
    返回:
    
    this
  - getTextAlign
```
public TextAlign getTextAlign()
```
    获取段落内字体浮动
    默认为左浮动
    
    返回:
    
    浮动方向
  - doPrepare
```
public Rectangle doPrepare(Double widthLimit)
```
    预布局
    该方法主要有渲染器调用，请勿主动调用该方法，除非你知道你在做什么。
    
    指定者:
    
    doPrepare 在接口中 RenderPrepare
    
    覆盖:
    
    doPrepare 在类中 Div<Paragraph>
    
    参数:
    
    widthLimit - 宽度限制
    
    返回:
    
    元素尺寸
  - contentSplitAdjust
```
public <T extends Div> Div[] contentSplitAdjust(double sHeight,
                                                T div1,
                                                T div2)
```
    从类复制的说明: Div
    
    内容分割调整
    根据分割高度调整两个克隆元素，达成分割元素的效果
    
    覆盖:
    
    contentSplitAdjust 在类中 Div<Paragraph>
    
    类型参数:
    
    T - Div子类泛型参数
    
    参数:
    
    sHeight - 分割内容的高度
    
    div1 - 克隆元素1
    
    div2 - 克隆元素2
    
    返回:
    
    分割调整后的两个Div
  - clone
```
public Paragraph clone()
```
    请勿调用该方法克隆段落，除非你知道你在干什么
    
    覆盖:
    
    clone 在类中 Div<Paragraph>
    
    返回:
    
    属性一模一样，但是没有任何内容的段落
  - elementType
```
public String elementType()
```
    元素类型
    关联渲染器：ParagraphRender
    
    覆盖:
    
    elementType 在类中 Div<Paragraph>
    
    返回:
    
    Paragraph

类 Paragraph

构造器概要

方法概要

从类继承的方法 org.ofdrw.layout.element.Div

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

构造器详细资料

Paragraph

Paragraph

Paragraph

Paragraph

Paragraph

Paragraph

Paragraph

Paragraph

方法详细资料

add

add

getLineSpace

setLineSpace

getDefaultFont

setDefaultFont

setDefaultFont

getFontSize

setFontSize

setFontSize

getContents

setContents

getLines

getFirstLineIndent

setFirstLineIndent

getFirstLineIndentWidth

setFirstLineIndentWidth

clearFirstLineIndent

setTextAlign

getTextAlign

doPrepare

contentSplitAdjust

clone

elementType