UserContext.GetRenderMode-渲染模式获取

1. 概述

1.1 功能概述

Wyn报表表达式提供 UserContext.GetRenderMode 函数获取报表的操作行为。预览、打印、导出报表时，使用这个函数可以分别获取到“preview”、“print”和“export”返回值。

• 语法： UserContext.GetRenderMode()

• 说明： 返回渲染模式："preview" (预览)、"print" (打印) 或 "export" (导出)

• 示例： {UserContext.GetRenderMode()}

2. 操作步骤

本节我们通过这个函数实现了在预览报表时仅显示可控的行数，方便快速了解报表的数据构成；而在导出或打印时，则全量打印或导出。

• 预览效果如下：

  
  

• 导出效果如下：

  
  

接下来为您介绍这个示例的制作过程。

1. 创建报表，添加一个整型的报表参数并设置一个默认值，如下所示。

   
   

2. 然后添加内嵌数据集，使用 UserContext.GetRenderMode 函数配合 IIF 和 limit 语句实现预期效果。

• 预览报表时： 查询语句实际为 select * from 订单明细 limit @预览行数，也就是根据参数值决定输出行数。

• 打印或导出报表时： 查询语句实际为 select * from 订单明细，也就是全量获取数据。

  
  

3. 设计报表内容，添加一个文本组件，用于显示 UserContext.GetRenderMode() 获取到的值。

   再添加一个表格显示数据集中获取到的数据。

   
   

4. 预览和导出即可实现文初的效果。

3. 示例资源下载

• 示例文件包： 下载后，您可直接导入至对应版本系统中查看使用。

  UserContext.GetRenderMode示例.zip

  type=info

  注意： 本示例压缩包基于8.1版本制作，请使用8.1及以上版本并参照导入与导出文档操作（低版本可能存在兼容性问题，建议升级）