下载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属性可用于将字段绑定到外部数据源。
报表控件开发–概述
若要创建一个新的报表控件，您必须：
- 选择一个base类，如果找不到合适的控件派生，请从XRControl类继承一个组件。
- 创建组件的对象模型，指定一组属性和相关属性，这些属性决定如何序列化属性以及如何在Property网格中显示属性。
- 为Visual Studio和End User Designer创建组件设计器，设计人员在设计时确定组件的外观和操作，根据需要添加属性。
- 选择组件的“brick”，一个明显的选择是基类创建的积木，但是，如果组件从XRControl类继承，则有两个选项 - 如果需要简单的Brick，则选择VisualBrick作为Brick的基类；如果需要的容器，则选择PanelBrick。
- 指定组件如何创建其"brick"，并将组件的属性映射到brick的特征。
- 实现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方法删除该地址类型不必要的属性。
