Previous topicNext topic
Help > 操作指南 > 页面报表/RDL报表操作方法 > 控件使用 >
添加文档目录

“文档目录”控件允许您在报表正文中显示文档结构，即报表书签标签和标题级别的有组织的层次结构及其页码。

使用标题级别属性向文档目录添加项

您可以使用 TextBox 控件的 HeadingLevel 属性为报表定义层次结构。例如，可以将显示报表标题的文本框的“标题级别”属性设置为 Heading1，然后将显示组标题的文本框的“HeadingLevel”属性设置为 Heading2，这会将所有 Heading2 条目组合在文档目录中的 Heading1 条目下。

这些步骤假定您已经设置了报表包含的 TextBox 控件的 HeadingLevel 属性。有关详细信息，请参阅向文档目录中添加项 。

  1. 在报表资源管理器中，右键单击报表项，然后选择报表属性...”
  2. 在出现的“报表属性”对话框中，转到“文档目录”页。
  3. 在“文档目录”页上，将“资源”设置为“只显示标题”，并选择性地从下拉列表中选择“编号样式”。提示： 还可以将“资源 ”设置为“标签和标题”，以在文档目录中同时包括标签和标题。
  4. 单击“确定”关闭对话框。

使用标签属性或文档目录标签向文档目录添加项

通过设置页面报表/RDL报表中控件的 Label 属性或文档目录标签，可以基于文档目录中控件之间的父子关系显示层次结构。例如，设置列表数据区域和 TextBox 控件的 Label 属性或文档目录标签，然后将 TextBox 控件放在列表数据区域内。查看文档目录时，“文本框”标签嵌套在“列表”数据区域标签内，从而显示层次结构。同样，如果在数据区域的多个组上设置文档目录标签，则它们在文档目录中以彼此嵌套的形式显示，显示与设置它们的层次结构相同的层次结构。

这些步骤假定您已经设置了报表包含的控件的 Label 属性或文档目录标签。有关详细信息，请参阅向文档目录添加项 。

  1. 在报表资源管理器中，右键单击该控件，然后选择“报表属性...”
  2. 在出现的“报表属性”对话框中，转到“文档目录”页。
  3. 在“文档目录”页中，将“源”设置为“仅标签”，并选择性地从下拉列表中选择“编号样式”。提示： 还可以将“资源”设置为“标签和标题”，以在文档目录中同时包括标签和标题。
  4. 单击“确定”关闭对话框。

向文档目录添加项

  1. 在设计图面上，选择要添加到文档目录的控件。
  2. 在“属性”窗口的命令部分中，单击“属性”对话框。这是用于打开控件对话框的命令。有关如何访问命令的详细信息，请参阅属性窗口。
  3. 在出现的对话框中，转到“导航”页，在“文档目录”标签下，输入表示文档目录中控件的文本或表达式。
  4. 单击“确定”关闭对话框。

添加和配置目录

按照以下步骤在显示上述过程中设置的文档目录集的报表布局中设置 DirectoryOfContents 控件。

在页面报表中添加文档目录控件

  1. 在报表设计器中，单击“新建”选项卡以向报表布局添加新页。
  2. 从工具箱中，将“文档目录”控件拖放到第 1 页上，同时使用第 2 页创建用于显示报表主要内容的布局。使用包含目录的同一页可能会中断报表中显示的数据流。
  3. 在设计图面上，选择“文档目录”控件，然后转到“属性”窗口以设置其“固定高度”属性。属性的使用类似于使用其他报表控件可用的 FixedSize 属性。注意： 还可以放置“溢出占位符”控件，并使用其 OverflowName 属性将其与“文档目录”控件链接，以显示不适合“文档目录”控件的固定大小的数据。
  4. 选中“文档目录”控件后，单击“级别（集合）”属性，然后单击出现的省略号按钮。
  5. 在出现的 LevelDesigner 集合编辑器中，考虑文档目录中显示的条目层次结构，并使用“添加”按钮添加所需的多个级别。这允许您自定义不同嵌套级别的条目。仅使用单个级别将列出同一级别的所有目录条目。还可以通过使用“报表”对话框或使用直接应用于“文档目录”控件的 DocumentMap 属性设置文档目录级别的编号样式，为所有级别或单个级别设置各种编号样式。有关详细信息，请参阅向文档目录添加项 。
  6. 选择每个级别，并在 LevelDesigner 集合编辑器中设置其相关属性。这些属性可以是常规属性，如 DisplayPageNumber 或 DisplayFillCharacter，也可以与关卡的外观相关，如背景颜色、字体、填充等。这些属性直接影响所选关卡中显示的所有条目，从而允许您自定义它们。有关“文档目录”控件的重要属性的信息，请参阅文档目录 。
  7. 单击“确定”关闭对话框并返回到设计图面。
  8. 转到“预览”选项卡以查看报表输出中显示的目录。
  9. 单击任何目录条目并导航到报表中的目标报表控件。

在报表定义语言 （RDL） 中添加文档目录控件

从工具箱中，将文档目录 控件拖放到报表设计图面上，最好在报表布局的开头或结尾，以证明控件的重要性。

配置目录外观
  1. 选中“文档目录”控件后，单击“级别（集合）”属性，然后单击出现的省略号按钮。
  2. 在出现的 LevelDesigner 集合编辑器中，考虑文档目录中显示的条目层次结构，并使用“添加”按钮添加所需的多个级别。这允许您自定义不同嵌套级别的条目。仅使用单个级别将列出同一级别的所有目录条目。
  3. 选择每个级别，并在 LevelDesigner 集合编辑器中设置其相关属性。这些属性可以是常规属性，如 DisplayPageNumber 或 DisplayFillCharacter，也可以与关卡的外观相关，如背景颜色、字体、填充等。这些属性直接影响所选关卡中显示的所有条目，从而允许您自定义它们。有关“文档目录”控件的重要属性的信息，请参阅目录。注意： 还可以通过使用“报表”对话框或使用直接应用于“文档目录”控件的 DocumentMap 属性来设置文档目录级别的编号样式，从而为所有级别或单个级别设置各种编号样式。有关详细信息，请参阅向文档目录添加项。
  4. 单击“确定”关闭对话框并返回到设计图面。
  5. 转到“预览”选项卡以查看报表输出中显示的目录。
  6. 单击任何目录条目，然后导航到报表中的目标报表控件。
将样式应用于“文档目录”控件

在“文档目录”控件中，可以使用 StyleName 属性应用样式。

  1. 创建一个新的样式表，并添加要应用于“文档目录”控件的样式。有关创建样式表和样式类型的详细信息，请参阅使用样式和样式元素。
  2. 将样式表应用于报表。有关如何在设计时将样式表应用于报表的详细信息，请参阅使用样式。
  3. 从工具箱中，将 ListOfContents 控件拖放到报表设计图面上，最好在报表布局的开头或结尾，以证明控件的重要性。
  4. 在设计图面上，选择“文档目录”控件。
  5. 在“属性”窗口中，从“样式名称”属性下拉列表中选择要应用于“文档目录”控件的样式。
将样式应用于目录级别

在“文档目录”控件中，可以使用“LevelDesigner 集合编辑器”对话框中提供的 StyleName 属性将样式应用于每个目录级别。

  1. 创建一个新的样式表，并添加要应用于目录级别的样式。有关创建样式表以及可用于目录级别的样式类型的详细信息，请参阅使用样式和样式元素。
  2. 从工具箱中，将 ListOfContents 控件拖放到报表设计图面上，最好在报表布局的开头或结尾，以证明控件的重要性。
  3. 选中“文档目录”控件后，单击“属性”窗口中的“级别（集合）”属性，然后单击出现的省略号按钮。
  4. 在出现的“关卡设计器集合管理器”对话框中，选择要应用样式的“文档目录”级别。
  5. 从右侧的属性列表中，下拉“样式名称”属性以选择要应用的样式。