全部展开
全部折叠默认情况下，ShowTagsInputDialog属性设置为false，标签对话框不显示。为了让用户在每一次C1PrintDocument文档生成时输入全部的标签，可以设置文档上的ShowTagsInputDialog属性为True。您所添加到文档的Tags集合的任何标签都将被自动展示在一个对话框里，每次即将生成文本时将显示给用户进行编辑。这使得最终用户有机会在Tags对话框编辑每一个标签值。
例如，下面的代码在 Form_Load事件向文档增加了三个标签，并向这些标签指定了文本值：
Visual Basic
| Visual Basic |
拷贝代码
|
|---|---|
Dim doc As New C1PrintDocument()
Me.C1PrintPreviewControl1.Document = doc
' 在文档生成时显示Tags对话框.
doc.ShowTagsInputDialog = True
' 创建将在Tags对话框中显示的标签
doc.Tags.Add(New C1.C1Preview.Tag("Statement", "Hello World!"))
doc.Tags.Add(New C1.C1Preview.Tag("Name", "ComponentOne"))
doc.Tags.Add(New C1.C1Preview.Tag("Location", "Pittsburgh, PA"))
' 向文档添加标签并生成文档.
Dim rt As New C1.C1Preview.RenderText()
rt.Text = "[Statement] My name is [Name] and my current location is [Location]."
doc.Body.Children.Add(rt)
doc.Generate()
|
|
C#
| C# |
拷贝代码
|
|---|---|
C1PrintDocument doc = new C1PrintDocument();
this.c1PrintPreviewControl1.Document = doc;
// 在文档生成时显示Tags对话框.
doc.ShowTagsInputDialog = true;
// 创建将在Tags对话框中显示的标签
doc.Tags.Add(new C1.C1Preview.Tag("Statement", "Hello World!"));
doc.Tags.Add(new C1.C1Preview.Tag("Name", "ComponentOne"));
doc.Tags.Add(new C1.C1Preview.Tag("Location", "Pittsburgh, PA"));
// 向文档添加标签并生成文档.
C1.C1Preview.RenderText rt = new C1.C1Preview.RenderText();
rt.Text = "[Statement] My name is [Name] and my current location is [Location].";
doc.Body.Children.Add(rt);
doc.Generate();
|
|
当应用程序运行时，以下对话框将在文档生成之前显示：
在任何文本框中改变文本将改变最终生成的文档中实际出现的文本。如果保留默认的文本，将在生成的文档产生以下文字：
Hello World! My name is ComponentOne and I'm currently located in Pittsburgh, PA.