itext7 - 如何在 PDF 中绘制水平虚线？

Question

我正在使用 itext7 的社区版本（版本7.1.9 ）。 我想创建一个 PDF 文档，在其中插入文本段落和一个水平分隔线，如下所示：

some interesting text
-----------
more interesting text
-----------
still interesting text
-----------
you get the idea
-----------

为了实现这个文档结构，我将Paragraph和LineSeparator与DashedLine类结合使用。 然而，即使有一个最小的例子，单个破折号最终都是垂直的，如下所示：

some interesting text
|||||||||||||
more interesting text
|||||||||||||

整体分隔符仍然水平运行，但传递width参数（如 Javadoc 中定义的）似乎实际上为行提供了高度。 我在这里做错了吗？

我该怎么做才能生成带有水平虚线的分隔符，其中虚线本身也是水平的（30.0 的宽度是一个通用示例）？

最小复制示例（Kotlin）：

import com.itextpdf.io.font.constants.StandardFonts
import com.itextpdf.kernel.font.PdfFontFactory
import com.itextpdf.kernel.pdf.PdfDocument
import com.itextpdf.kernel.pdf.PdfWriter
import com.itextpdf.kernel.pdf.canvas.draw.DashedLine
import com.itextpdf.layout.Document
import com.itextpdf.layout.element.LineSeparator
import com.itextpdf.layout.element.Paragraph
import java.io.File

object DashedLineBugReproduction {
    private fun render() {
        val docWriter = PdfWriter(File("/tmp/foobar_dashes.pdf"))
        val document = PdfDocument(docWriter)

        document.writeContents()

        document.close()
    }

    fun PdfDocument.writeContents() {
        val doc = Document(this)

        val font = PdfFontFactory.createFont(StandardFonts.TIMES_ROMAN)

        val dashedLine = LineSeparator(DashedLine(30f))
        val paragraph = Paragraph("Lorem ipsum dolor sit amet.")
            .setFont(font)
            .setFontSize(20f)

        doc.add(dashedLine)

        for (i in 0 until 8) {
            doc.add(paragraph)
            doc.add(dashedLine)
        }

        doc.close()
    }

    @JvmStatic
    fun main(args: Array<String>) {
        render()
    }
}

结果输出文件（截图，如果需要，我可以提供PDF）：

Answer 1

width 参数不设置线段的宽度，而是设置恰好由线段组成的水平线的宽度，因此没有错误。

默认情况下，线段之间的距离在DashedLine不可配置，但您可以创建自己的类并覆盖draw操作以创建自己的外观。

如果您希望您的线包含更长的段，您可以使用setLineDash方法的unitsOn 、 unitsOff和phase参数。 这里只是一个参考实现和视觉效果：

private static class CustomDashedLine extends DashedLine {
    public CustomDashedLine(float lineWidth) {
        super(lineWidth);
    }

    @Override
    public void draw(PdfCanvas canvas, Rectangle drawArea) {
        canvas.saveState()
                .setLineWidth(getLineWidth())
                .setStrokeColor(getColor())
                .setLineDash(20, 4, 2)
                .moveTo(drawArea.getX(), drawArea.getY() + getLineWidth() / 2)
                .lineTo(drawArea.getX() + drawArea.getWidth(), drawArea.getY() + getLineWidth() / 2)
                .stroke()
                .restoreState();
    }
}

创建LineSeparator时只需使用这个新实现：

LineSeparator dashedLine = new LineSeparator(new CustomDashedLine(3f));

结果如下所示：