为 iTextSharp 中的 pdf 单元格添加页眉、页脚和背景颜色

Question

我将 iTextSharp 用于 PDF 文档创建器。我想添加标题，它是一个文本和它下面的一行，然后是要出现的表格。页脚应包含右下角的页码。我能够创建表格，但页眉和页脚似乎是一个问题。有人可以给出一个示例代码来解决这个问题。我还想为表格中的标题列着色，即只有第一行的标题列具有背景颜色。我是新手，所以请帮帮我。提前致谢。

Answer 1

请检查列出与 iText 相关的主题的关键字列表。现在选择关键字页眉/页脚。您会发现页眉和页脚是使用页面事件添加的。

它是这样工作的：当您创建文档时，您可以将对象添加到文档中，而不必担心这些对象在不同页面上的分布。例如：aPdfPTable不适合一页时被拆分，不适合的部分转发到下一页。

每次发生这种情况时，iText 都会调用一个事件。如文档所述，在OnStartPage()方法中添加内容是危险的，因此如果您想添加页眉和页脚，则需要在OnEndPage()事件中这样做。

让我们从我的书的第 5 章中选择一个 C# 示例。在MovieHistory2 中，我们创建了一个这样的页面事件：

class HeaderFooter : PdfPageEventHelper {
  /** Alternating phrase for the header. */
  Phrase[] header = new Phrase[2];
  /** Current page number (will be reset for every chapter). */
  int pagenumber;

  /**
   * Initialize one of the headers.
   * @see com.itextpdf.text.pdf.PdfPageEventHelper#onOpenDocument(
   *      com.itextpdf.text.pdf.PdfWriter, com.itextpdf.text.Document)
   */
  public override void OnOpenDocument(PdfWriter writer, Document document) {
    header[0] = new Phrase("Movie history");
  }

  /**
   * Initialize one of the headers, based on the chapter title;
   * reset the page number.
   * @see com.itextpdf.text.pdf.PdfPageEventHelper#onChapter(
   *      com.itextpdf.text.pdf.PdfWriter, com.itextpdf.text.Document, float,
   *      com.itextpdf.text.Paragraph)
   */
  public override void OnChapter(
    PdfWriter writer, Document document,
    float paragraphPosition, Paragraph title) 
  {
    header[1] = new Phrase(title.Content);
    pagenumber = 1;
  }

  /**
   * Increase the page number.
   * @see com.itextpdf.text.pdf.PdfPageEventHelper#onStartPage(
   *      com.itextpdf.text.pdf.PdfWriter, com.itextpdf.text.Document)
   */
  public override void OnStartPage(PdfWriter writer, Document document) {
    pagenumber++;
  }

  /**
   * Adds the header and the footer.
   * @see com.itextpdf.text.pdf.PdfPageEventHelper#onEndPage(
   *      com.itextpdf.text.pdf.PdfWriter, com.itextpdf.text.Document)
   */
  public override void OnEndPage(PdfWriter writer, Document document) {
    Rectangle rect = writer.GetBoxSize("art");
    switch(writer.PageNumber % 2) {
    case 0:
      ColumnText.ShowTextAligned(writer.DirectContent,
        Element.ALIGN_RIGHT, 
        header[0],
        rect.Right, rect.Top, 0
      );
      break;
    case 1:
      ColumnText.ShowTextAligned(
        writer.DirectContent,
        Element.ALIGN_LEFT,
        header[1],
        rect.Left, rect.Top, 0
      );
      break;
    }
    ColumnText.ShowTextAligned(
      writer.DirectContent,
      Element.ALIGN_CENTER, 
      new Phrase(String.Format("page {0}", pagenumber)),
      (rect.Left + rect.Right) / 2, 
      rect.Bottom - 18, 0
    );
  }
}

请注意，该OnChapter()方法可能与您无关：它在事件中存储章节的标题并使用该标题作为标题。您应该感兴趣的部分可以在OnEndPage()方法中找到。每次页面结束时，我们都会在绝对位置添加内容。

您希望内容是一个表格吗？没问题，这正是MovieCountries1示例中所做的。

创建页面事件后，实现该OnEndPage()方法，您所要做的就是将事件声明为PdfWriter：

TableHeader tevent = new TableHeader();
writer.PageEvent = tevent;

为表格中的单元格背景着色是一件轻而易举的事。第 4 章对此进行了解释。

PdfPCell cell = new PdfPCell(new Phrase("red cell"));
cell.BackgroundColor = BaseColor.RED;

我假设您刚刚为我们的信息添加了该评论，这不是一个实际问题，但我还是回答了它，以防设置单元格的背景颜色对您来说不是微不足道的。当然，您可以毫无问题地找到创建像这样的PDF 的示例，这是一个带有重复页眉和页脚行的 PDF，其中页眉和页脚单元格具有不同的颜色。