界面控件DevExpress中文教程：如何PDF图形对象的可见性？

DevExpress拥有.NET开发需要的所有平台控件，包含600多个UI控件、报表平台、DevExpress Dashboard eXpressApp 框架、适用于 Visual Studio的CodeRush等一系列辅助工具。屡获大奖的软件开发平台DevExpress 近期重要版本v24.1已正式发布，该版本拥有众多新产品和数十个具有高影响力的功能，可为桌面、Web和移动应用提供直观的解决方案，全面解决各种使用场景问题。

复杂的PDF文档，如CAD图纸、技术施工计划、分层艺术品、地图或多语言文档，都充满了视觉信息，PDF层通常用于简化这些文档并提高整体可读性(图层允许您有选择地查看/隐藏部分)。

在本文中，我们将介绍几个直接与图层相关的使用场景，并向您展示如何使用DevExpress PDF Viewer和PdfDocumentProcessor (PDF文档API)来控制DevExpress驱动的应用程序中的图层可见性(层可见性支持在v24.1中引入)。

获取DevExpress v24.1正式版下载

控制图层可见性

您可以使用PdfOptionalContentGroupVisibility.Visible属性为适当的层或在DevExpress PDF查看器的图层面板中设置PDF图层可见性。要显示一个图层，单击其相关的复选框(可见图层用“眼睛”图标表示)。

您还可以通过Document Facade API管理图层的可见性，当一个图层被添加到文档中时，用户必须指定默认配置(基于状态的层设置)。例如，您的配置可以指定给定的图层在查看时隐藏，但在打印时可见。当您加载一个文档时，可以获得默认的图层配置(PdfOptionalContentProperties.DefaultConfiguration属性值)，并指定用于启用图层设置的类别：

• View（视图） - 在视图状态下应用于图层的设置(当您在查看器中显示文档时)。
• Print（打印） - 在打印预览模式或打印文档时应用于图层的设置。
• Export（导出） - 导出文档时应用于图层的设置。
• Zoom（缩放） - 基于缩放级别的图层设置。
• Language（语言） - 应用于图层的语言文化设置。

例如，如果您将ActiveUsages设置为PdfOptionalContentUsageCategories，打印时只有默认配置中的打印设置在打印文档时应用于图层，其他默认设置自动禁用，您可以将ActiveUsages设置为none来禁用所有默认设置并仅应用当前设置。

重要提示：PDF文档只存储默认的内容配置，这意味着在保存文档时不会保留图层可见性，可见性设置适用于在PDF Viewer组件中预览文档、打印文档或将其导出为图像时。

用例1：从不同的角度分析报告数据

在这个示例中包含销售指标的PDF包含多个图层，其中包含针对不同人员的注释。您可以在查看文档时控制PDF查看器中的图层可见性，这允许您在不增加报表页面数量的情况下显示适当的注释。

用例2：缩放时显示详细信息

在本例中，带有地图的PDF文件使用200%缩放的不同图层(显示额外的数据)。

用例3：打印时给文档贴标签

在本例中打印文档中添加了 DevExpress logo， logo被放置在一个单独的图层上，包括以下配置设置：

它在查看文档时隐藏，但在打印/导出此文档时呈现。

对于这个场景，我们启用了配置图层的打印使用：

using DevExpress.Pdf;
using System;
using System.Linq;
using DevExpress.Drawing;

static void Main(string[] args) {
using (PdfDocumentProcessor processor = new PdfDocumentProcessor()) {
processor.LoadDocument("PdfLayers.pdf");
// Specify which settings from the default configuration will be applied for each layer contained in a document.
processor.DocumentFacade.OptionalContentVisibility.ActiveUsages = PdfOptionalContentUsageCategories.Print;
// Print the document.
DXBitmap bitmap = processor.CreateDXBitmap(1, 1000);
PdfPrinterSettings pdfPrinterSettings = new PdfPrinterSettings();
processor.Print(pdfPrinterSettings);
}
}

输出如下：

正如前面提到的，图层支持实在v24.1发布周期中引用的。