表达式,脚本,标签.docxVIP

表达式，脚本，标签表达式（或脚本–这两个术语会在这里交替使用）可以在整个文档的不同的地方使用。通过一对方括号标记一个表达式，如下面的代码所示：Visual BasicDim doc As New C1PrintDocument() doc.Body.Children.Add(NewRenderText(2+2= [2+2]))C#C1PrintDocumentdoc= new C1PrintDocument(); doc.Body.Children.Add(newRenderText(2+2= [2+2]));此代码将在生成的文档中产生以下文字：2+2=4在这种情况下，[2+2]被解释为一个表达式，并计算出最终的文本。注意：如果表达式解析器无法解析包含在方括号内的文本，比方说文本无法被理解为一个表达式，则将文本原样插入文档。标签标签与表达密切相关。事实上，标签是变量，可在表达式中使用，或者简单地作为表达式。标签允许您在希望向某个目标位置插入某个特定的字符串，但尚未确定该字符串的值的情况下，使用一个占位符。一个标签的典型例子是页码，您需要打印页码，但是目前还无法确认页码到底显示什么，或者在文档重新生成时，页码还可能发生变化。标签有两个主要的属性：Name以及Value。Name属性来识别标签，而Value属性则是表示标签将被替换为的值。C1PrintDocument 提供两种标签：预定义标签和自定义标签。预定义的标签包括：[PageNo]–将使用当前的页码替代。[PageCount] –将使用总页数替代。[PageX]–使用当前水平方向上的页码替代。[PageXCount] –使用当水平方向上的总页数替代。[PageY]–使用当前垂直方向的页码替代（如果不存在水平方向上的分页，则这和 [PageNo]结果相等）。[PageYCount] –使用当前垂直方向上的总页数替代（如果不存在水平方向上的分页，则这和 [PageCount]结果相等）。自定义标签存储在文档的Tags集合中。为了向该集合添加一个标签，您可以使用下面的代码：VisualBasicdoc.Tags.Add(New C1.C1Preview.Tag(tag1,tagvalue))C#doc.Tags.Add(new C1.C1Preview.Tag(tag1,tagvalue));当创建标签时标签的值可以保留为未指定状态，并可以在稍后的某一个时机指定它（即使是在标签应用到文本之后的某个时机）。在希望使用标签的位置，将标签的名字包含在一对方括号中以使用该标签，例如，就像这样：VisualBasicDim rt As New C1.C1Preview.RenderText()rt.Text= The valueof tag1willappear here: [tag1].C#RenderTextrt= new RenderText();rt.Text= Thevalueof tag1willappearhere:[tag1].;标签/表达式语法如果需要，您可以将用来包括标签或者用文本表示的脚本的方括号改成任意字符串，通过文档的TagOpenParen以及TagCloseParen属性。在您的文档可能包含大量正常方括号字符串时，这种修改能力是一种很好的主意，因为默认情况下，这些方括号将触发表达式解析，即使不影响显示结果，也会消耗大量的资源。所以，您可以这样做：VisualBasicdoc.TagOpenParen= @@@[ doc.TagCloseParen= @@@]C#doc.TagOpenParen= @@@[; doc.TagCloseParen= @@@];将确保只有被@@@[ 和@@@]包含的字符串被会被解释为表达式。表达式的括号也可以通过在之前添加转义字符进行转义，例如以下代码：VisualBasicDim doc As New C1PrintDocument() doc.Body.Children.Add(newRenderText(2+2= \[2+2\]))C#C1PrintDocumentdoc= new C1PrintDocument(); doc.Body.Children.Add(newRenderText(2+2= \[2+2\]));将在生成的文档中产生以下文本：2+2= [2+2]因为括号已被转义。文档的TagEscapeString可以被用作将转义字符指定为任意字符串。在运行时编辑标签值您可以给最终用户显示一个窗体，允许查看并编辑位于C1PrintDocument组件的Tags集合中的标签的标签值。有几个新成员支持该选项，允许您创建一个自定义的窗体，用来显示特定的标签。对于您创建的标签窗体，您可以设置几个选项。你可以：每次C1Prin