众所周知，交互式表单（AcroForms）是PDF标准的重要组成部分，AcroForms允许开发者和开发者的用户创建可填写的PDF文档。尽管WinForms和WPF PDF Viewers不支持交互式表单生成，但开发者可以在应用程序中加入AcroForm designer，并提供两种简单的解决方法。本文主要为大家介绍如何使用DevExpress Reports和PDF Viewer创建AcroForm Designer。

使用DevExpress Reports创建交互式表单

如果您从头开始生成文档或需要将AcroForms与现有报表集成，则可以使用End User Report Designer来创建交互式表单，您需要：

Label – 用于创建文本字段Character Comb – 用于创建文本字段（每个字符打印在单个单元格中）Check Box – 用于在PDF文件中创建复选框和单选按钮组。

要在生成的PDF文档中启用编辑，请在设计器中将EditOptions | Enabled属性设置为true（如下图所示），或在将控件添加到报表时在代码中启用编辑模式：

var designForm = new XRDesignForm();designForm.DesignMdiController.DesignPanelLoaded += (panel, args) =>((XRDesignPanel)panel).ComponentAdded += (s, componentEventArgs) => {XRLabel label = componentEventArgs.Component as XRLabel;if (label != null)label.EditOptions.Enabled = true;XRCheckBox checkBox = componentEventArgs.Component as XRCheckBox;if (checkBox != null)checkBox.EditOptions.Enabled = true;};designForm.OpenReport(report);designForm.ShowDialog();

要将这些字段作为交互式表单字段导出为PDF，请通过设计器的UI或代码启用将编辑字段导出到AcroForms：

report.ExportToPdf(pdfFileName,new PdfExportOptions { ExportEditingFieldsToAcroForms = true });

DevExpress安装附带了WinForms，WPF，ASP和ASP NET.Core平台的电子表格演示，请注意查看实施细节，点击立即下载>>

使用DevExpress PDF Viewer和PDF Document API创建交互式表单

此操作允许开发者为现有PDF文档（例如扫描的纸质表单）创建交互式表单，它使用PDF Document API将AcroForm子弹添加到WinForms/WPF PDF Viewer中显示的PDF文档中。API允许您根据需要修改表单字段外观和操作。

请按照以下步骤将文本框字段添加到文档：

1. 使用PdfViewer.GetDocumentPosition方法指定表单字段的边界及其在页面上的位置。

使用MouseDown和MouseUp事件绘制文本框字段（基于指定的坐标）， GetDocumentPosition方法将鼠标坐标转换为文档中的页面坐标。

int pageNumber;PdfPoint c1, c2;void pdfViewer_MouseDown(object sender, MouseEventArgs e) {var documentPosition = pdfViewer.GetDocumentPosition(e.Location, true);// Obtain the page number where the text box should be placed.pageNumber = documentPosition.PageNumber;// Obtain the page coordinates.c1 = documentPosition.Point;}void pdfViewer_MouseUp(object sender, MouseEventArgs e) {// Obtain the page coordinates.c2 = pdfViewer.GetDocumentPosition(e.Location, true).Point;}// Create the rectangle that specifies the text box's size and location.var fieldBounds = new PdfRectangle(Math.Min(c1.X, c2.X), Math.Min(c2.Y, c2.Y),Math.Max(с1.X, с2.X), Math.Max(с1.Y, с2.Y));

2. 在文档页面上创建文本框字段。

var field = new PdfAcroFormTextBoxField(“FieldName”, pageNumber, fieldBounds) {Text = “Initial value”,Multiline = true,Type = PdfAcroFormTextFieldType.PlaneText,TextAlignment = PdfAcroFormStringAlignment.Far,Appearance = Appearance.CreateAcroFormFieldAppearance(),ReadOnly = false,Required = true,Print = true,ToolTip = “Text form field tooltip”;}

3. 修改表单字段外观。

创建PdfAcroFormFieldAppearance的实例并指定字段的背景和前景颜色，显示其边框并配置字段文本的字体属性。

public PdfAcroFormFieldAppearance CreateAcroFormFieldAppearance() {var acroFormFieldAppearance = new PdfAcroFormFieldAppearance();acroFormFieldAppearance.BackgroundColor = ToPdfColor(BackgroundColor);acroFormFieldAppearance.ForeColor = ToPdfColor(ForeColor);acroFormFieldAppearance.BorderAppearance = new PdfAcroFormBorderAppearance() {Color = ToPdfColor(BorderColor),Width = BorderWidth,Style = BorderStyle};Font font = Font;if (font == null) {acroFormFieldAppearance.FontFamily = null;acroFormFieldAppearance.FontSize = 0;acroFormFieldAppearance.FontStyle = PdfFontStyle.Regular;}else {acroFormFieldAppearance.FontFamily = font.FontFamily.Name;acroFormFieldAppearance.FontSize = font.SizeInPoints;acroFormFieldAppearance.FontStyle = (PdfFontStyle)font.Style;}return acroFormFieldAppearance;}

请注意每个PDF颜色分量由范围（0,1）内的浮点值表示。 将GDI颜色转换为PDF颜色，如下所示：

static PdfRGBColor ToPdfColor(Color color) {return color.IsEmpty ? null: new PdfRGBColor(color.R / 255.0, color.G / 255.0, color.B / 255.0);}

开发者可以使用相同的方法创建其他表单字段类型，有关交互式表单域的其他信息，请查看以下文档主题。

PDF表单创建演示中使用了此实现。 您可以在DevExpress演示源目录（C：\ Users \ Public \ Documents \ DevExpress Demos 18.2 \ Components \ Office File API \ ...）中找到演示源代码。

基于Web的PDF Viewer

注意：目前不提供基于Web的PDF Viewer，但是开发者可以使用PDF Document API为PDF Viewer for ASP.NET and MVC创建自定义Viewer，创建完成后，可以使用此处的相同方法将交互式表单域添加到PDF文档中。

=======================================================

DevExpress v18.2全新发布，更多精彩内容请持续关注DevExpress中文网！