OISClientLauncher 控件

上次修改时间： 2010年10月20日

适用范围： SharePoint Foundation 2010

一个允许 Microsoft SharePoint Foundation 2010 用户使用 Microsoft Office Picture Manager 的 ActiveX 控件。

备注

此控件在 OISCTRL.dll 文件中定义，后者是一个在安装 Microsoft Office 时安装在客户端计算机上的 %ProgramFiles%\Microsoft Office\Office14\ 目录下的动态链接库 (DLL)。

若要实例化此控件，请在 ECMAScript（JavaScript、JScript） 中使用以下函数：

var obj = new ActiveXObject('OISCTRL.OISClientLauncher');

在 Microsoft Visual Basic Scripting Edition (VBScript) 中，可使用以下函数实例化此控件：

Set obj = CreateObject('OISCTRL.OISClientLauncher')

在上述两种情形中，参数为控件 OISCTRL.OISClientLauncher 的编程标识符 (ProgId)。有关 ProgId 的详细信息，请参阅 <ProgId> 项（该链接可能指向英文页面）。

在 SharePoint Foundation 2010 中，当打开包含图片库视图的页面时，IMGLIB.js 文件中的代码将确定是否已安装 Microsoft Office，如果已安装，则会实例化该控件。

下面的 Microsoft Visual Basic Scripting Edition 代码演示该控件的典型用法。

Set OISClientLauncher = CreateObject("OISCTRL.OISClientLauncher")
fClientInstalled = IsObject(OISClientLauncher)

if (fClientInstalled = True) Then OISClientLauncher.LaunchOIS(cmdLine)
Set OISClientLauncher = Nothing

在此示例中，cmdLine 是一个字符串。在将 cmdLine 传递到 OIS 之前，该控件会验证其格式是否正确以及是否安全。

OIS 命令行参数

可采用四种模式从命令行调用 OIS.exe。这些模式使用以下参数：

• upload folder_url（字符串）

  允许将一组图像上载到图片库中的文件夹。folder_url 参数是图片库中您要将图像上载到的文件夹的路径。

• editSP lib_url（字符串）id1（整数）id2（整数）… id(n)（整数）

  允许编辑图片库中的一组选定图片。lib_url 参数可指定您要编辑的图片库的路径，而且每个 id 参数都是一个整数，该整数与您要编辑的图片库中的图像相对应。

• download lib_url（字符串）id1;id2;…;id(n) （字符串）jpg（字符串）1024x768（字符串）

  允许以指定大小和格式下载选定图片。lib_url 是从中下载图片的图片库的路径。id1;id2 … 是要下载的图片。jpg 是一个字符串，用于确定下载时要将图像转换为的目标格式。1024 x 768 是一个字符串，它可以是一个介于 1 和 100 之间的数字（这些数字被解释为图像大小的百分比），也可以是某个用于确定要下载的图像大小的 x * y 值。

• sendto lib_url（字符串）id1;id2;…;id(n)（字符串）

  将图片库中的一组图片发送到其他某个应用程序。lib_url 是要从中发送图片的图片库的路径。id1;id2 … 是要发送的图片。