<OBE Template>

使用对象模型脚本在 Resource Manager 中管理图像

目的

本教程将向您介绍如何通过使用对象模型在 Resource Manager 中管理图像。

所需时间

大约 15 分钟

主题

本教程包括下列主题：

	概述
	情景
	前提条件
	在 Resource Manager 中管理图像
	为对象模型脚本设置提示
	更改信息板控件属性
	总结
	相关信息

查看屏幕截图

将鼠标置于此图标上以加载和查看本教程的所有屏幕截图。（警告：因为此操作会同时加载所有屏幕截图，所以网速较慢时，响应时间可能会比较长。）

注：此外，您还可以在下列步骤中将鼠标放在每个单独的图标上，从而仅加载和查看与该步骤相关的屏幕截图。可以通过单击各个屏幕截图来将其隐藏。

概述

Resource Manager 是一个用于在 Interactive Reporting 文档中加载、管理和共享图片的用户界面实用程序。您可以在 Resource Manager 中存储一份图片的副本，并当您在文档其他位置再次使用时引用该副本。这样，Resource Manager 缩小了 Interactive Reporting 文档的大小，并提高了打开文档时的性能。例如，公司的徽标可能在一个 Interactive Reporting 文档中多次出现在报表标题和信息板上。借助 Resource Manager，只需存储一份备份并通过对其资源名称的引用即可重用。

可以在 Resource Manager 中通过对象模型使用脚本自动化来搜索、计数、添加或删除存储在 Resource Manager 中的图像，而不是使用 Interactive Reporting Studio 界面直接访问 Resource Manager 中的图像。

可以从以下方法中选择用来在 Resource Manager 中管理图像的方法：

Add()		向 Resource Manager 添加指定的图像并分配所选显示名称。
Item()		使用图像 uid 作为搜索条件来搜索图像条目。
FindItems()		使用 displayName 作为搜索条件搜索图像。
Count		保存在 Resource Manager 中注册的图像数目。
CreateIterator()		按顺序访问所有集合项。
Remove()		从 Resource Manager 中删除指定的图像。
RemoveAll()		从 Resource Manager 中删除所有图像。

这些方法可在 Interactive Reporting Studio 和 Interactive Reporting Web Client 中使用。

每个方法都有其各自的语法。例如，向 Resource Manager 添加脚本的一个典型语法是
ActiveDocument.ResourceManager.Images.Add(string path, string displayName)。

参数：

Path	所选图像的文件系统路径
displayName	图像显示名称或图像文件名称

确保您在文件系统路径中的每个文件夹级别前输入两个反斜线。
例如，如果图像 Server.gif 存储在本地硬盘驱动器的 Images 文件夹中，脚本应如下所示

ActiveDocument.ResourceManager.Images.Add("C:\\Images\\Server.gif").

返回主题列表

情景

作为一名报表设计人员，您需要创建一个带有控件的信息板并将其用于管理 Resource Manager 中的图像。您将创建带有警报的脚本以验证脚本自动化是否成功。

返回主题列表

前提条件

开始本教程之前，您应该：

1.	可以浏览和查看对象模型
2.	在身份验证目录中有用户帐户
3.	有一定的脚本自动化经验
4.	可以访问本地驱动器上的图像

返回主题列表

在 Resource Manager 中管理图像

在本主题中，您将创建脚本来自动化 Resource Manager 中的图像管理。首先，需要插入一个信息板。然后，添加一个信息板控件并应用对象模型脚本。

要添加用于 Resource Manager 中图像管理的对象模型脚本，执行以下步骤：

1.	在 Interactive Reporting Studio 中，创建或打开一个 Interactive Reporting 文档。
2.	选择 Insert > Dashboard。显示一个空白信息板部分。信息板处于默认模式，设计模式。
3.	在 Elements 窗格中，展开 Controls 文件夹。显示信息板控件。
4.	将 Command Button 控件拖放至信息板内容窗格。该控件添加至信息板。系统自动为该控件指定名称 CommandButton1。
5.	右键单击命令按钮。显示快捷菜单。
6.	选择 Scripts。显示 Script Editor。可以将已经创建的脚本复制并粘贴到 Script Editor 中。
7.	保留 Event Trigger 的默认选项为 onClick。
8.	输入用于 Resource Manager 中图像管理的脚本，并单击 Check Syntax 按钮确保正确的括号数。在本示例中，脚本将向 Resource Manager 添加一个图像。ActiveDocument 是一个 Interactive Reporting 文档 PCW_Annual_Report_2008.bqy，图像文件名为 Comupter.gif。完整的脚本应如下所示： ActiveDocument.ResourceManager.Images.Add("C:\\Computer.gif")
9.	单击 OK。保存了控件 CommandButton1 的脚本。
10.	选择 Dashboard > Design Mode 信息板模式更改为运行模式。
11.	单击命令按钮。图像已从本地驱动器添加到 Resource Manager。
12.	选择 Tools > Resource Manager 验证图像是否添加成功。显示 Resource Manager。添加的图像作为可用资源列出，供以后在 Interactive Reporting 文档中使用。

返回主题列表

为对象模型脚本设置提示

在本主题中，您将向脚本添加一个提示。在 Interactive Reporting 中，继续使用相同的文档。您将调用脚本并验证脚本自动化是否成功。

要添加一个提示，执行以下步骤：

在 Interactive Reporting 中，选择 Dashboard 部分。

显示 Dashboard 部分。

选择 Dashboard > Design Mode。

信息板模式处于设计模式。

右键单击命令按钮并选择 Scripts。

显示 Script Editor。可以使用 Alert() 脚本方法添加提示。

在原有脚本的上方输入以下文本：

Alert("Adding Image to the Resource Manager");

修改原有文本，使其包含一个提示并添加一个额外的图像。

在本示例中，修改文本以添加图像 lobalNetwork.gif。

单击 OK。

脚本随即更新。

选择 Dashboard > Design Mode。

信息板模式处于运行模式。

单击命令按钮。

显示第一条提示。

单击 OK。

显示第二条提示，确认脚本是否成功运行。

如果脚本运行失败，您将看到一个包含空值的提示。

10.

单击 OK。

11.

选择 Tools > Resource Manager。

在 Resource Manager 对话框中列出了新的图像。

返回主题列表

更改信息板控件属性

在本主题中，您将更改信息板控件的属性。在 Interactive Reporting 中，继续使用相同的文档。

要添加一个警报，执行以下步骤：

在 Interactive Reporting 中，选择 Dashboard 部分。

显示 Dashboard 部分。

选择 Dashboard > Design Mode。

信息板模式处于设计模式。

右键单击命令按钮并选择 Properties。

显示 Properties 对话框。

在 Title 文本框中，为命令按钮输入一个描述或者标题，并在 Settings 下选择 Locked。

可以更改字体大小属性，如样式、大小、颜色和效果。可以指定该控件以及其他控件的选项卡顺序。可以添加当鼠标指针置于控件上时作为工具提示显示的注释。

在本示例中，CammandButton1 的标题是 Add Image。因为该控件现在已锁定，所以不会误移动或误删除命令按钮。在解锁之前，不可剪切或复制控件。

单击 OK。

命令按钮将显示新标题。

选择 Dashboard > Design Mode。

信息板模式更改为运行模式。显示重命名的命令按钮。

选择 File > Save。

您的更改已保存。

返回主题列表

总结

在本教程中，您学习了如何：

	使用对象模型脚本在 Resource Manager 中管理图像
	为对象模型脚本设置提示
	更改信息板控件属性

返回主题列表

	要了解更多关于对象模型和信息板开发服务的信息，请参阅 OTN 网站上文档库中的“Object Model and Dashboard Development Services Developer’s Guide”（卷 1-7）。
	要了解更多关于 Interactive Reporting 的信息，可以参考 OTN 网站上的其他 OBE。