本文档说明了 XtraReports 支持什么度量单位,以及如何改变特定报表当前使用的度量单位系统。
本文档由下列小节组成。
所支持的度量单位
报表控件、带区 和报表自身的所有大小和位置,都以报表内相同的单位度量。 度量单位由报表的 XtraReport.ReportUnit 属性指定,可以设置为下列类型之一:
-
百分之一英寸
当 ReportUnit 属性值被设置为 ReportUnit.HundredthsOfAnInch 时使用。 -
十分之一毫米
当 ReportUnit 属性值被设置为 ReportUnit.TenthsOfAMillimeter 时使用。
下表列出了所有以报表的 XtraReport.ReportUnit 属性指定的单位进行度量的属性。
属性 |
简要说明 |
---|---|
XRControl.Height | 获取或设置控件的高度。 |
XRControl.Width | 获取或设置控件的宽度。 |
XRControl.Left | 获取或设置控件左边缘的横座标。 |
XRControl.Top | 获取或设置控件上边缘的纵座标。 |
XRControl.Bottom | 获取控件下边缘的纵座标。 |
XRControl.Right | 获取控件右边缘的横座标。 |
XRControl.Height | 获取或设置控件或带区的高度。 |
XRLine.LineWidth | 获取或设置线条的粗细度。 |
XRShape.LineWidth | 获取或设置用于绘制形状图像的线条的粗细度。 |
XRBarCode.Module | 获取或设置在当前 XRBarCode 实例中最窄的条形或空白的宽度。 |
XRCrossBandControl.StartPoint | 获取或设置跨带区控件开始绘制的起始点。 |
XRCrossBandControl.EndPoint | 获取或设置控件结束绘制的终点。 |
XtraReport.PageHeight | 获取或设置报表页的高度。 |
XtraReport.PageWidth | 获取或设置报表页的宽度。 |
XtraReport.Margins | 获取或设置报表页的页边空白。 |
MultiColumn.ColumnWidth | 获取或设置在打印多栏报表时的栏宽。 |
MultiColumn.ColumnSpacing | 获取或设置在绘制多栏报表时的栏间距。 |
注意,尽管 XtraReports 中的大部分尺寸都是以报表的度量单位进行度量的,但是仍然以像素为单位来度量某些属性,以便于提供品质更好的输出报表 (包括 打印 和 导出 报表)。 这组例外的属性包括: XRControl.BorderWidth、XRCrossBandBox.BorderWidth 和 XRZipCode.SegmentWidth。 因此,这些属性始终被使用像素单位存储,但是当使用当前的 XRControl.Dpi 属性值创建报表时,会被转换为当前的度量单位。
例如,所指定的度量单位会影响 XtraReport.SnapGridSize 属性的行为,并会影响报表元素可以被移动或调整大小的最小幅度。 要获知相关细节,请参阅 基本原理.控件布置。
改变当前的度量单位
在默认情况下,每个新报表的 XtraReport.ReportUnit 属性值都被设置为 ReportUnit.HundredthsOfAnInch。 但是可以轻松改变当前的度量单位,方法是在 属性网格 中找到此属性,并设置为 ReportUnit.TenthsOfAMillimeter。
注意,每当报表的度量单位被改变时,以报表单位进行度量的所有属性值都被重新计算。 在设计时刻管理报表布局得需要这样。 因此,如果在运行时刻指定了控件的高度或宽度,就需要人为关注用于度量高度及宽度的报表单位。
特别地,所指定的度量单位会影响 XtraReport.SnapGridSize 属性,并会影响报表元素可以被移动或调整大小的最小幅度。 要获知相关细节,请参阅 控件布置。
注意 |
---|
如果控件在运行时刻被创建,但没有添加到任何报表中 (在 C# 中其 XRControl.RootReport 属性返回 null,或者在 Visual Basic 中返回 Nothing),那么控件的宽度和高度 始终 以百分之一英寸度量。 |