如何创建自定义DevExpress报表控件，看完你就懂了

下载DevExpress v20.1完整版

40分钟教你入门DevExpress v20.1最新推出控件——甘特图，立即报名>>

DevExpress Winforms Controls 内置140多个UI控件和库，完美构建流畅、美观且易于使用的应用程序。

本文记录如何构建自定义的DevExpress Report控件（Swiss QR-Bill报表组件），以及如何解决开发过程中遇到的问题，希望这些信息对创建自定义DevExpress Report控件的用户有价值。

为帮助消除报表控件开发过程中的神秘性，本文介绍如何创建设计时设置、序列化设计器组件和相关的“bricks”，以及如何渲染和打印组件。第一部分包含有关Swiss QR Bill控件的一般信息，并描述控件本身的要求；第二部分详细介绍了组件的实现。

一般信息

Swiss QR Bill是一种带有QR码的新型付款单，Swiss QR Bill包含以下元素：

• 收据
• 付款部分
• 条码

发票可以使用以下布局：

• 在A4纸上打印的“全额”发票；
• 在A6纸上打印的“简短”发票；
• 连续打印发票；
• 在单个页面上打印的发票。

“完整”发票包含收据，而“空”发票仅包含付款信息。 组件的BillKind属性指定完整发票的PaymentAndReceipt值和短期发票的PaymentOnly值，连续打印或单独打印是通过IntegratedMode属性指定的。

将发票打印在A4或A6纸上（或导出为PDF），并分别通过BillOption.PreviewSeparatorKind和BillOption.PdfSeparatorKind属性指定perforation line。该组件允许您更改任何字段的语言和字体，StringData属性可用于将字段绑定到外部数据源。

报表控件开发–概述

若要创建一个新的报表控件，您必须：

1. 选择一个base类，如果找不到合适的控件派生，请从XRControl类继承一个组件。
2. 创建组件的对象模型，指定一组属性和相关属性，这些属性决定如何序列化属性以及如何在Property网格中显示属性。
3. 为Visual Studio和End User Designer创建组件设计器，设计人员在设计时确定组件的外观和操作，根据需要添加属性。
4. 选择组件的“brick”，一个明显的选择是基类创建的积木，但是，如果组件从XRControl类继承，则有两个选项 - 如果需要简单的Brick，则选择VisualBrick作为Brick的基类；如果需要的容器，则选择PanelBrick。
5. 指定组件如何创建其"brick"，并将组件的属性映射到brick的特征。
6. 实现BrickExporter类来呈现 "brick"，覆盖用于绘图和导出的方法。

以下各部分详细介绍了如何更详细地构建SwissQRBill组件。

组件实现

由于SwissQRBill组件是XRControl的后代，因此它在设计器的工具箱中具有自己的 "brick"、序列化和项。

设计时

要将组件添加到Visual Studio工具箱，该组件必须具有ToolBoxItem（true）属性。

WinForms End-User Designer要求向IToolBoxService注册该组件，处理DesignPanelLoaded事件，然后调用IToolBoxService.AddToolBoxItem方法来注册组件。

若要实现组件的设计时功能，请分别为Visual Studio和WinForms End-User Designer添加Designer和XRDesigner属性。控件的调整大小规则和智能标记项必须根据需要进行修改，智能标记项是通过在组件设计器中注册的DesignerActionList对象指定的， GetSelectionRulesCore方法修改控件的调整大小规则。

设置属性网格时，请特别注意可扩展对象。 在此示例中，将创建ExpandableObjectConverter后代以重写ConvertTo方法，新的ConvertTo方法实现更改了在属性网格编辑器中显示的字符串。 AddressTypeConverter的GetProperties方法删除该地址类型不必要的属性。

---

DevExpress技术交流群2：775869749      欢迎一起进群讨论