1、先来个简单的例子:
该报表例子只包含一条信息: “Hello, World!”。打开模板设计器并点击对象工具条上的“文本”按钮,把鼠标移到设计区并点击,文本对象就插入在鼠标的位置。
文本编辑容器打开,如果文本编辑容器没有自动打开,则可以双击文本对象来打开它。文本编辑器打开与否可以在设计器选项中进行设置。在文本框里输入“Hello, World!”并点击OK按钮
至此,模板设计完成。点击菜单“文件|预览”或点击工具条上相应的按钮以预览报表。预览容器显示包含“Hello, World!”的文本。该报表可以打印、保存成一个文件或导出为支持文件。
2、了解文本对象:
文本”对象有很多特性,允许用户显示文本、边框、填充颜色等,它可以通过任何字体、 任何大小、任何样式进行显示。所有的参数基本上可以通过工具栏按钮的帮助进行设置完成。
下面是一些“文本”对象使用示例:
接下来我们来看看“文本”对象的其他特性。创建一个新“文本”对象关显示两行文字:
This is a very, very, very long text line.
And this is another line, the shorter one.
设置边框,然后通过鼠标把对象改变成 9×3 厘米的矩形。我们会看到组件不止显示一行文 本文字,而是显示多行文本文字。在改变组件宽度到5厘米,很显然,长的行没有显示完整而 是换行显示。这是因为“WordWrap”属性设置为True的结果,如果设置为False,则长文本就会被截断。
现在我们看看组件内部文字对齐的功能,对齐按钮位于“Text”工具栏上,允许用户设置 文本的水平或垂直对齐属性。注意“
”按钮,这个按钮可以让段落分别向组件的两个边缘对齐,此时“WordWrap”属性必须置为True才行。
组件中的文字都可以在0到360度范围进行任意角度的旋转,“Text”工具栏中的 按钮能让用户快速将文字旋转45度、90度、180度、270度。如果你想让文字旋转任意角度,可以通过 对象监视器。“
”属性设置文字旋转的角度。如果文字旋转不是90、180、270度,则 文字可能超出组件范围,此时可以通过调整组件大小来显示文本。
现在我们简单看一下"Text"组件的其他属性,这些属性可能影响组件的外观显示,他们只能在对象查看器中进行设置:
- BrushStyle: 对象填充类型
- CharSpacing: 文字间的间隙(以像素计)
- GapX, GapY: 设置文字水平方向和垂直方向缩进情况(以像素计)。
- LineSpacing: 行之间的间隙大小(以像素计)。
- ParagraphGap: 段落开始缩进情况(以像素计)。
3、文本”对象中一些简单的HTML标签:
文本”对象可以识别一“些简单的HTML标签,可以在对象文本中增加简单HTML标签。HTML标签特性默认是禁用的,可以通过右键菜单“允许HTML标记”或对象检查器中“AllowHTMLTags”属性启用。以下是支持的标签
<b> : 粗体
<i> : 斜体
<u> : 下划线
<sub> : 下标
<sup> : 上标
<font color> : 字体颜色
<nowrap> : 当“nodwrap”启用时,文本不折行,整体移入下一行。
要注意“文本”对象只支持部分标签,但这对于一般的应用已经足够。不能通过HTML标签更改字体大小和名称,否则对字体的描述将变得十分复杂。
以下是如何使用HTML标签的一些例子:
text <b>bold text</b> <i>text in italic</i> <b><i>bold and in italic</b></i>
E = mc<sup>2</sup>
A<sub>1</sub> = B<sup>2</sup>
this is a usual text, <font color=red>and this is a red one</font>
this is a usual text, <font color="#FF8030">and this is an orange one</font>
4、文本对象显示表达式:
这个基本组件一个最重要的特性是不但可以显示静态的文字,而且可以显示表达式的值。表达式可 以和文字混合编辑,下面让我们看一下如何实例表达式。把下面的文字输入“文本”对象:
Hello, World! Today is [DATE].
当报表运行后我们获得如下结果:
Hello, World! Today is 01.01.2004.
怎么得到这种结果呢?当康虎云报表渲染报表时,组件中遇到有方括号里面的公式,报表 引擎计算公式并将计算结果插入到公式的位置。“文本”组件可以由任意多个表达式混合组成复合表达式。复合表达式可以带括号(例如:[1+2*(3+4)]),常量、变量、函数和数据字段都可用于表达式。我们将在后面的章节中学习如何使用这些。
康虎云报表会自动把方括号里的内容识别为表达式,但在有些情况下我们不想让报表引擎把方括号内的内容都识别成表达式,例如:
a[1] := 10
报表引擎将把[1]认为是表达式而显示为:
a1 := 10
这不是我们想要的结果,当然,有一种方式是设置“AllowExpressions”为False来禁用表达式(也可以从右键菜单“允许表达式”去掉勾选 )禁用之后,报表引擎就会显示我们想要的内容:
a[1] := 10
但在某些情况下方括号里的内容有些是表达式,有些又不是表达式,例如
a[1] := [myVar]
这种情况下直接禁用表达式就达不到我们想要的结果。康虎云报表提供了表达式定义符重设功能,通过“ExpressionDelimiters”属性把默认的表达式定义符“[,]”设置成其他定义符,下面的例子就是把表达式定义符改成“<,>”:
a[1] := <myVar>
夫达式定义符的格式是“<,>”,前两个定义符之间用“,”分开,另外一个要求是开始标记和结束标记不能相同,所以“%,%”是无效的。也可以使用复合标记,例如:“<%,%>”,我们的例子就如下所示:
a[1] := <%myVar%>