文档查看器

使用“文档查看器”控件呈现文档并在您的应用程序中内联显示。 例如，您可以使用“文档查看器”控件来显示可能位于各种来源（例如存储桶、实体或公共链接）中的发票文档或收据。

“文档查看器”控件不支持本地计算机上的文件。您必须使用 URL、存储桶或实体引用远程文档。

将文件分配给应用程序变量时，请确保变量的类型为IResource 。

如果只想显示图像，建议使用“图像”控件。

重要提示：

文档查看器使用内置的 PDF.js 查看器，该查看器在各浏览器中保持一致。无需配置浏览器。从外部文件服务器加载 PDF 时，服务器必须支持跨域请求。如果未启用 CORS，则内置的 PDF.js 查看器将无法呈现文档。

将文档查看器与存储桶一起使用

如果在应用程序中使用存储桶，则 文档查看器 控件的“ 来源”属性必须为IResource 变量：

1. 向您的应用程序添加“从存储桶下载”规则。

2. 将IResource变量绑定到“从存储桶下载”规则。
3. 将相同的IResource 变量绑定到 文档查看器 的“ 来源” 属性。

使用 IResource

如果您以ILocalResource形式获取文件，则系统会使用以下方法自动将其转换为IResource ：

JobAttachment.fromResource(file) // file is a ILocalResource

重要提示：

以下函数已弃用，不应再使用：

• .toLocalResource
• .到 Apps 文件

页面导航

您可以使用以下命令，以编程方式导航到文档查看器中的特定页面：

appsFile.NavigateToPage(pageNumber)

常规

• “来源”- 要显示的文档的来源。支持的文件类型为 PDF 文档和图像（JPEG、PNG、BMP、GIF 和 WEBP）。
• 隐藏 - 如果为 True，则在 Runtime 隐藏该控件。
• “已禁用”- 如果为 True，则在 Runtime 禁用该控件。

Events

无事件。

样式

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。

• “边框”- 控件的边框。可以配置边框粗细、颜色和半径。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “大小” - 控件的宽度和高度。 默认情况下，大小设置为auto ，这意味着320 x 410px 。 要设置最小值或最大值，请选择三点图标 (...)。

VB 属性

VB 属性	数据类型	描述
Source	IResource	当前查看的源文件。
Value	IResource	文档查看器控件附加或输出的值。
Hidden	布尔值	如果为 True，则在 Runtime 隐藏该控件。
Disabled	布尔值	如果为 True，则在 Runtime 禁用该控件。