Partager via

OISClientLauncher, contrôle

  • Article

Dernière modification : mercredi 20 octobre 2010

S’applique à : SharePoint Foundation 2010

Contrôle ActiveX qui permet aux utilisateurs de Microsoft SharePoint Foundation 2010 de recourir à Microsoft Office Picture Manager.

Remarques

Ce contrôle est défini dans le fichier OISCTRL.dll, bibliothèque de liens dynamiques (DLL) installée dans le répertoire %ProgramFiles%\Microsoft Office\Office14\ sur l’ordinateur client pendant l’installation de Microsoft Office.

Pour instancier le contrôle, utilisez la fonction suivante en ECMAScript (JavaScript, JScript) :

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

Dans Microsoft Visual Basic Scripting Edition (VBScript), utilisez la fonction suivante pour instancier le contrôle :

Set obj = CreateObject('OISCTRL.OISClientLauncher')

Dans les deux cas, l’argument est l’identificateur programmatique (ProgId) du contrôle, OISCTRL.OISClientLauncher. Pour plus d’informations sur les ProgId, voir Clé <ProgID> (éventuellement en anglais).

Dans SharePoint Foundation 2010, lorsqu’une page qui contient un affichage d’une bibliothèque d’images s’ouvre, le code dans le fichier IMGLIB.js détermine si Microsoft Office est installé et, si tel est le cas, instancie le contrôle.

Le code Microsoft Visual Basic Scripting Edition suivant illustre l’utilisation classique du contrôle.

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

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

Dans cet exemple, cmdLine est une chaîne. Le contrôle vérifie que cmdLine est formé correctement et sûr avant de le transmettre à OIS.

Paramètres de ligne de commande OIS

Il existe quatre modes pour appeler OIS.exe à partir de la ligne de commande. Les modes prennent les paramètres suivants :

  • upload folder_url (string)

    Permet le téléchargement d’un ensemble d’images dans un dossier de la bibliothèque d’images. Le paramètre folder_url est le chemin d’accès au dossier de la bibliothèque d’images dans lequel vous souhaitez télécharger les images.

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

    Permet la modification d’un ensemble d’images sélectionnées de la bibliothèque d’images. Le paramètre lib_url spécifie le chemin d’accès à la bibliothèque d’images que vous modifiez et chaque paramètre id est un entier qui correspond à une image de la bibliothèque d’images que vous souhaitez modifier.

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

    Permet le téléchargement des images sélectionnées dans un format et une taille spécifiés. lib_url est le chemin d’accès à la bibliothèque d’images à partir de laquelle vous téléchargez les images. id1;id2… sont les images que vous téléchargez. jpg est une chaîne qui détermine le format auquel les images doivent être converties lorsque vous effectuez le téléchargement. 1024x768 est une chaîne qui représente soit un nombre compris entre 1 et 100, qui est interprété comme le pourcentage de la taille de l’image, soit une valeur x par y qui détermine la taille de l’image que vous souhaitez télécharger.

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

    Envoie un ensemble d’images d’une bibliothèque d’images à une autre application. lib_url est le chemin d’accès à la bibliothèque d’images à partir de laquelle les images sont envoyées. id1;id2… sont les images que vous envoyez.