文档目录(TableOfContents简称Toc)报表控件用于在报表正文中显示文档结构图,即报表标题级别和标签及其页码的有组织的层次结构。控件允许您在 ActiveReports 支持的所有查看器中快速了解和导航报表内的数据。与仅在查看器中可用且无法呈现或打印的文档结构图不同,您可以使用 DirectoryOfContents 控件在表体中嵌入 DirectoryOfContents 结构,以便进行打印和呈现。通过将 DirectoryOfT 报表控件从工具箱拖放到报表设计图面上,可以将该控件添加到报表中。
在“属性”窗口中,有许多属性可用于控制“目录”报表控件的外观和行为。例如,可以使用 OverflowName 属性指定 OverflowPlaceHolder 控件名称,以将其与 DirectoryOfContents 控件链接。属性允许您设置每页上目录控件的最大高度,类似于其他报表控件提供的 FixedSize 属性。属性允许您应用样式表中的选定样式。可以使用 StyleName 属性将这些样式应用于目录报表控件,或使用 LevelDesigner 集合编辑器对话框应用于目录级别。有关如何设置样式的详细信息,请参阅添加文档目录 。
Levels 属性包含目录级别的集合,并允许您访问“LevelDesigner 集合编辑器”对话框,您可以在其中设置报表目录级别及其属性。属性限制文档结构图中的最大级别数。
对文档结构图所做的任何自定义(如使用“报表”对话框或使用 DocumentMap 属性为文档结构图级别设置编号样式)都将直接应用于“目录”控件。有关详细信息,请参阅向文档结构图添加项。
目录属性对话框
目录的属性在“目录”对话框中可用。若要打开它,请在报表上选择“目录”控件的情况下,在“属性窗口”下,单击“属性对话框...”链接。
“目录属性”对话框允许您使用以下页面设置报表控件的属性。
注意:您可以单击<表达式...>其中许多属性以打开表达式编辑器,您可以在其中创建表达式以确定值。
名称:输入在报表中唯一的目录名称。可以在代码中调用此名称。您只能在“名称”字段中使用下划线 (_) 作为特殊字符。不支持其他特殊字符,例如句点 (.)、空格 ( )、正斜杠 (/)、反斜杠 (\)、感叹号 (!) 和连字符 (-)。
工具提示:报表项的文本标签,用于在 HTML 报表中包含 TITLE 或 ALT 属性。
默认情况下,目录在报表运行时可见,但您可以隐藏它,仅在满足特定条件时隐藏它,或者使用另一个报表控件切换其可见性。
初始化可见性
可见:报表运行时,目录可见。
隐藏:报表运行时,目录处于隐藏状态。
表达式:使用具有布尔结果的表达式来确定目录是否可见。真表示隐藏,假表示可见。
可见性可以通过其他报表元素进行切换:选中此复选框可在另一个报表控件旁边显示切换目录。这将启用下拉框,您可以在其中指定 TextBox 控件,如果单击该控件,将切换目录的可见性。
边框
样式:选择边框样式。
宽度:输入一个以磅为单位的值以设置边框的宽度。
颜色:选择要用于边框的颜色,或选择<表达式...>用于打开表达式编辑器并创建计算结果为 .NET 颜色的表达式的选项。
背景
颜色:选择要用于背景的颜色。
数据输出
元素名称:输入要在目录报表控件的 XML 输出中使用的名称。
输出:选择“自动”、“是”、“否”以决定是否在 XML 输出中包含此目录。选择“自动”将导出“目录”报表控件的内容。
明细数据编辑器用于设置报表目录级别及其属性。若要访问“明细数据编辑器”对话框,请转到“属性”窗口,然后在“Levels”属性中单击“(集合)”。
您可以从以下位置设置目录级别属性:
1.点击“明细数据编辑器”对话框左边的成员中的对象。
外观
BackgoundColor:背景颜色,选择要用于目录级别背景的颜色。
Color:颜色,选择文本的颜色。
Font:字体,选择要呈现目录级别文本的字体。
Style:风格,选择“正常”、“斜体”或选择“<表达式...>用于打开表达式编辑器并创建表达式的选项。
Family:字体名称,选择字体系列名称。
Size:大小,选择字体的大小(以磅为单位)。
Weight:重量,从“较浅”、“较细”、“超轻”、“浅”、“正常”、“中”、“半粗”、“粗”、“超粗”、“重”和“粗体”中进行选择,或选择<“表达式...>用于打开表达式编辑器并创建表达式的选项。
Padding:填充,指定要应用于目录级别的填充的左值、右值、顶部值和底部值。
StyleName:样式名称,选择要应用于目录级别的样式。
TextAlign:文本对齐,指定文本的水平对齐方式。
TextDecoration:文字装饰,从“无”、“下划线”、“上划线”和“透线”中进行选择,或选择<“表达式...>用于打开表达式编辑器并创建表达式的选项。
数据
DataElementName:数据元素名称,输入要在此目录级别的 XML 输出中使用的名称。
常规
DisplayFillCharacters:显示填充字符,指定是否显示前导字符。默认值为 True。
DisplayPageNumber:显示页码,指定是否显示页码。默认值为 True。
FillCharacter:填充字符,使用该表达式为前导字符指定填充字符。
布局
TextIndent:文本缩进,指定文本缩进。
杂项
Name:名字,指定目录级别的名称。