界面控件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被放置在一个单独的图层上,包括以下配置设置:

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

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

cs 复制代码
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发布周期中引用的。

相关推荐
界面开发小八哥4 小时前
界面控件DevExpress WinForms v24.2 - 数据处理功能增强
.net·界面控件·devexpress·ui开发·winforms
向宇it9 小时前
【unity游戏开发——编辑器扩展】使用EditorGUI的EditorGUILayout绘制工具类在自定义编辑器窗口绘制各种UI控件
开发语言·ui·unity·c#·编辑器·游戏引擎
小众AI10 小时前
UI-TARS: 基于视觉语言模型的多模式代理
人工智能·ui·语言模型
开开心心就好11 小时前
高效全能PDF工具,支持OCR识别
java·前端·python·pdf·ocr·maven·jetty
花落已飘13 小时前
LVGL(lv_btnmatrix矩阵按钮)
ui·c·lvgl
kooboo china.13 小时前
在UI 原型设计中,交互规则有哪些核心要素?
ui·编辑器·交互
编程乐趣14 小时前
推荐一个Winform开源的UI工具包
microsoft·ui·开源
绿龙术士18 小时前
构建现代化WPF应用:数据驱动开发与高级特性解析
c#·wpf
yngsqq20 小时前
JPG与PDF格式转换器
pdf
读心悦1 天前
CSS结构性伪类、UI伪类与动态伪类全解析:从文档结构到交互状态的精准选择
css·ui·交互