DevExpress WinForms使用教程：使用DevExpress Reports和PDF Viewer创建AcroForm Designer

---

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

使用DevExpress Reports创建交互式表单

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

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

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

演示中使用了此实现。 您可以在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中文网微信公众号，及时获取最新动态及最新资讯