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')

どちらの場合も、引数はコントロールのプログラム識別子 (ProgID) (OISCTRL.OISClientLauncher) です。ProgId の詳細については、「<ProgId> Key (英語)」を参照してください。

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 を呼び出すには、4 つのモードがあります。各モードが、以下のパラメーターを受け取ります。

  • upload folder_url (string)

    画像ライブラリ内のフォルダーに一連のイメージをアップロードできるようにします。folder_url パラメーターには、画像ライブラリ内のイメージのアップロード先とするフォルダーのパスを指定します。

  • editSP lib_url (string) id1 (int) id2 (int) …id(n) (int)

    画像ライブラリにある選択した一連の画像を編集できるようにします。lib_url パラメーターには、編集する画像ライブラリのパスを指定し、各 id パラメーターには、画像ライブラリ内の編集したいイメージに対応する整数値を指定します。

  • download lib_url (string) id1;id2;…;id(n) (string) jpg (string) 1024x768 (string)

    選択した画像を指定したサイズと形式でダウンロードできるようにします。lib_url は、ダウンロード元の画像ライブラリのパスです。id1;id2 は、ダウンロードする画像です。jpg は、ダウンロードする際にイメージをどの形式に変換するかを決定する文字列です。1024 x 768 には、1 ～ 100 の数字を指定するか (イメージのサイズのパーセンテージとして解釈されます)、またはダウンロードするイメージのサイズを決定する x と y の解像度値を指定します。

  • sendto lib_url (string) id1;id2;…;id(n) (string)

    画像ライブラリ内の一連の画像を、別のアプリケーションに送信します。lib_url は、画像の送信元となる画像ライブラリのパスです。id1;id2 は、送信する画像です。