MindFusion.Reporting for WinForms程序员指南：报告项目介绍

以下项目可用于MindFusion.Reporting报告中。大部分的报表项目都有两个共同的属性。位置和大小–分别指定元素相对于其父元素的位置，以及其大小。

MindFusion.Reporting for WinForms是一个原生的Windows Forms编程组件，它为任何.NET应用程序提供专业的报表功能。该组件完全使用C#语言编写，易于使用和集成。它提供您创建一个完美报表所需要的一切。MindFusion.Reporting for WinForms现已加入在线订购，Standard Single Developer版本原价2848现在抢购立享优惠只需2345，立即查看详情>>

MindFusion.Reporting for WinForms最新试用版

报告项目

以下项目可用于MindFusion.Reporting报告中。大部分的报表项目都有两个共同的属性。位置和大小–分别指定元素相对于其父元素的位置，以及其大小。

页面

页面是MindFusion.Reporting报表的最基本元素。报表中的页面由Page类的对象表示。每个报表可以包含任意数量的页面。页面本身可以包含任意数量的其他报表元素，如标签和数据范围。当报表通过调用其Run方法进行处理时，如果目标空间不足以容纳处理后的页面内容，则页面可以被分割。

属性

最值得注意的页面属性是背景、边框和PageOrientation。前两个属性定义了页面的背景和边框。后者用于指定页面的方向。如果PageOrientation被设置为Unspecified，则页面的实际方向由传递给Report类的Layout方法的defaultPageOrientation参数决定

页眉和页脚

每个页面都可以选择包含页眉和/或页脚，页眉显示在页面顶部，而页脚显示在底部。页眉显示在页面顶部，而页脚显示在底部。如果在报告处理过程中拆分了一个页面，那么在最终布局中，页面的每一次出现都会显示页眉和页脚。您可以通过报表设计器（请参见报表设计器）或通过代码为页面指定页眉和/或页脚。后者需要您分别为页面的页眉或页脚属性分配一个PageSection对象。下面的代码说明了这一点。
C#

// 创建标题PageSection header = new PageSection();// 通过添加各种报告项目，在这里对头部进行初始化。//到它，例如// 将页眉设置为页面page.Header = header.Head;

VB.NETCopy

' Create the headerDim header As New PageSection()' Perform initialization of the header here, by adding various report items' to it, for example' Set the header to a pagepage.Header = header

有各种属性，如Border、Background和Visible，它们会影响最终布局中页眉和页脚的可视化。

标签

标签元素在报表中显示文本。标签由Label类表示。标签显示的文本可以是静态的，也可以是来自数据源的值或通过表达式计算的值。此外，文本可以包含各种格式指定符，如<b>、<i>等。标签显示的文本是通过其Text属性指定的。

数据绑定的标签

数据绑定的标签只能在DataRange对象中创建，标签的数据源由其包含的DataRange对象的DataSource属性指定。标签的数据源由其包含的DataRange对象的DataSource属性指定。标签所绑定的数据字段的名称通过DataField属性指定。设置 DataField 时，标签的 Text 属性被忽略，显示的文本由数据源中相关字段的值决定。

表达式

标签可以显示比静态和数据字段值更复杂的文本。您可以在标签的文本中包含所谓的表达式。当文本被处理时，其中的表达式将被评估，表达式将被替换为评估结果。

在标签文本中嵌入表达式时，请将表达式用方括号括起来。例如，下面的标签文本是有效的，它将显示字符串 “Date:”，后面是评价时系统的日期。注意，例子中的表达式用粗体高亮显示。

Date: [Now()]

上述文本的评估结果将是类似于 “日期：12/10/2008 2:23:38 PM “的内容。

可以为表达式的值指定格式。要做到这一点，请在表达式之后但在结尾’]’之前添加一个’@’符号，然后添加用引号括起来的代表格式化指定器的字符串。下面的例子通过向生成的日期添加格式化来扩展前一个例子。注意，例子中的格式指定符用粗体高亮显示。

Date: [Now()@"d"]

现在，评估结果将类似于以下内容。”日期：12/10/2008″。

有关MindFusion.Reporting中表达式的更多信息，请访问Expressions。关于如何在标签文本中使用表达式的更多信息，请查看在报表中使用表达式。

属性

除了文本和数据字段属性外，标签还暴露了其他一些属性，可用于进一步自定义标签文本的外观。Alignment（对齐方式）、LineAlignment（行对齐方式）、Padding（填充）、Color（颜色）和Font（字体）控制了标签文本的显示方式以及在标签范围内的位置。

数据范围

数据范围元素提供了一种在MindFusion.Reporting报表中执行数据绑定的方法。数据范围由DataRange类表示。关于如何使用数据范围进行数据绑定的广泛信息可以在Binding Reports to a Data Source主题中找到。

属性

DataRange对象暴露了一些常见的可视化属性，如Background和Border。还有两个附加属性–AlternatingBackground和AlternatingBorder，这两个属性都默认为null（在Visual Basic中为Nothing）。当这些属性被分配的值与空值不同时，它们将被用作最终布局中该数据范围的每第二个出现的背景和边框。换句话说，Background 和 Border 用于数据范围的奇数出现，而 AlternatingBackground 和 AlternatingBorder 用于偶数出现。

AllowSplit 属性被设置为 false 时，可防止数据范围在处理报表时分裂成多个页面。ArrangeByX 属性指定是否先水平布置数据范围实例，然后再垂直布置。如果 ArrangeByX 设置为 false（默认值），则无论 x 轴上是否有空间，数据范围的实例总是垂直排列。Repeat 属性用于断开的数据范围，以指定这些数据范围在最终布局中出现的次数。

图片

图片元素使您能够将静态图片添加到报表中。图片由Picture类表示。与标签类似，如果图片被放置在一个数据绑定的DataRange元素中，那么它们就可以被数据绑定。要将图片绑定到数据源中的一个字段，请使用其DataField属性。

属性

要为图片指定静态图像，请使用图像属性。图片的边框和背景可以分别通过边框和背景属性来指定。您可以通过RotationAngle属性将图像任意旋转。通过ImageAlign属性可以控制显示的图像的对齐方式。

画布

画布元素可用于在报表中执行自定义渲染。画布元素由Canvas类表示。为了在画布中执行绘制，您需要处理其RenderContents事件。传递给该事件处理程序的DrawCanvasEventArgs参数包含一个IGraphics对象，该对象可用于执行必要的绘制。

数据绑定的画布

您可以用绑定标签和图片的同样方式对画布进行数据绑定–将它们放置在数据绑定的DataRange中，并为其DataField属性设置适当的值。通过数据绑定获得的值会通过事件参数的DataValue属性提供给RenderContents事件处理程序。

图表

MindFusion.Reporting提供了四种可以在报表中使用的图表类型。它们由BarChart, LineChart, PieChart和RadarChart类表示。这些类中的每一个都提供了一组属性，让你可以自定义图表的外观。更多信息，请阅读各个类的主题。关于如何在报表中使用图表的更多信息，请访问报表中的图表。

分页符

分页符是一种特殊的报表元素，由PageBreak类表示。分页符不会出现在报表的最终布局中。当在布局过程中遇到分页符时，它会强制（如其名称所示）创建一个新的页面，并在这个新页面上继续布局。分页符不应该放在页面以外的容器中，否则可能会导致不可预测的结果。

属性

PageBreak对象唯一值得注意的属性是它在其包含元素中的位置，由Location属性指定。

行

线条元素使您能够将彩色直线添加到报表中。线条由线条类来表示。

属性

线条对象暴露了两个属性，它们定义了线条相对于其包含的元素的位置–StartPoint和EndPoint。线条的外观可以通过颜色、DashStyle和宽度属性来修改。

椭圆

椭圆元素类似于线条–它们使您能够在报表中添加一个静态形状，即椭圆。

椭圆元素的属性

要修改椭圆的外观，请使用颜色、DashStyle和宽度属性。

想要购买该产品正版授权请点击【商城购买】，想了解更多产品信息请点击【咨询在线客服】

标签：

来源：慧都