首页 > 解决方案 > itext7 - 如何在 PDF 中绘制水平虚线?

问题描述

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

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

为了实现这个文档结构,我将Paragraphs 和 aLineSeparatorDashedLine类结合使用。然而,即使有一个最小的例子,单个破折号最终也会垂直,如下所示:

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): 有问题的输出

标签: javapdfkotlinitext7

解决方案


width 参数不设置线段的宽度,而是设置恰好由线段组成的水平线的宽度,因此不会出现错误。

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

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

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));

结果如下所示:

结果


推荐阅读