使用C1PrintDocument控件 > 表达式,脚本,标签 > 标签 |
标签与表达密切相关。事实上,标签是变量,可在表达式中使用,或者简单地作为表达式。标签允许您在希望向某个目标位置插入某个特定的字符串,但尚未确定该字符串的值的情况下,使用一个占位符。一个标签的典型例子是页码,您需要打印页码,但是目前还无法确认页码到底显示什么,或者在文档重新生成时,页码还可能发生变化。
标签有两个主要的属性:Name 以及 Value。Name属性来识别标签,而Value属性则是表示标签将被替换为的值。
C1PrintDocument 提供两种标签:预定义标签和自定义标签。预定义的标签包括:
自定义标签存储在文档的Tags集合中。为了向该集合添加一个标签,您可以使用下面的代码:
Visual Basic
Visual Basic |
拷贝代码
|
---|---|
doc.Tags.Add(New C1.C1Preview.Tag("tag1", "tag value")) |
C#
C# |
拷贝代码
|
---|---|
doc.Tags.Add(new C1.C1Preview.Tag("tag1", "tag value")); |
当创建标签时标签的值可以保留为未指定状态,并可以在稍后的某一个时机指定它(即使是在标签应用到文本之后的某个时机)。
在希望使用标签的位置,将标签的名字包含在一对方括号中以使用该标签,例如,就像这样:
Visual Basic
Visual Basic |
拷贝代码
|
---|---|
Dim rt As New C1.C1Preview.RenderText() rt.Text = "The value of tag1 will appear here: [tag1]." |
C#
C# |
拷贝代码
|
---|---|
RenderText rt = new RenderText(); rt.Text = "The value of tag1 will appear here: [tag1]."; |