Instrumenpoche

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Accéder au cœur d'Instrumenpoche par javascript ======

**Avertissement** Ce qui suit sera fonctionnel sur la prochaine version d'instrumenpoche : 2.5

Lorsqu'Instrumenpoche est inséré dans une page HTML, il est possible d'accéder aux objets qu'il contient par javascript. 

Trois fonctions permettent d'accéder au contenu d'instrumenpoche : la première permet de lire une propriété d'un objet d'instrumenpoche, la deuxième permet de modifier une propriété et la troisième d'exécuter une fonction contenue dans instrumenpoche. Une quatrième fonction (''iep_loaded()'') est automatiquement appelée au chargement d'instrumenpoche.

Pour avoir la liste des classes d'instrumenpoche et les propriétés et méthodes qu'elles contiennent, voir [[start|la page d'accueil pour les développeurs]].

===== Accéder à instrumenpoche =====
Pour utiliser les fonctions de communication avec instrumenpoche, il est nécessaire d'y avoir accès. Pour cela, on peut définir une fonction qui renvoie une animation Flash contenue dans la page, connaissant son nom. Celle-ci peut être :
<code javascript>
function thisMovie(movieName) {
   var isIE = navigator.appName.indexOf("Microsoft") != -1;
   return (isIE) ? window[movieName] : document[movieName];
}
</code>

Ainsi, si le fichier SWF d'instrumenpoche se nomme ''iep'', on pourra y avoir accès par :
<code javascript>
thisMovie("iep")
</code>

Le nom est ''iep'' lorsque l'animation est par exemple incluse dans la page HTML par :
<code XML>
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" 
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0" 
width="800" height="600" id="iep" align="middle">
<param name="allowScriptAccess" value="always" />
<param name="allowFullScreen" value="true" />
<param name='Flashvars' value='iep_anim_echap=' />
<param name="movie" value="iep.swf" />
<param name="quality" value="high" />
<param name="bgcolor" value="#ffffff" />
<embed src="iep.swf" Flashvars='iep_anim_echap='  quality="high" bgcolor="#ffffff" 
     width="800" height="600" name="iep" align="middle" 
     wmode="window" allowScriptAccess="always" allowFullScreen="true" 
     type="application/x-shockwave-flash" 
     pluginspage="http://www.adobe.com/go/getflashplayer_fr" />
</object>
</code>

===== Lire une propriété =====
La fonction permettant de lire une propriété est :
<code javascript>
get_iep(objet,propriété)
</code>
Où ''objet'' est un texte désignant l'objet contenant le propriété, et le deuxième argument est un texte désignant la propriété voulue.
Par exemple, en détectant instrumenpoche comme ci-dessus, on peut afficher l'abscisse du crayon par :
<code javascript>
alert(thisMovie("iep").get_iep("CrayonIep.crayon","_x"));
</code>

===== Modifier une propriété =====
La fonction permettant de lire une propriété est :
<code javascript>
set_iep(objet,propriété,valeur)
</code>
Où ''objet'' est un texte désignant l'objet contenant le propriété, et le deuxième argument est un texte désignant la propriété voulue et le troisième la valeur qu'on veut donner à la propriété.
Par exemple, en détectant instrumenpoche comme ci-dessus, on peut modifier l'abscisse du crayon par :
<code javascript>
thisMovie("iep").set_iep("CrayonIep.crayon","_x",500);
</code>

**Attention** le troisième argument de la fonction est la valeur, et non un texte la désignant. Par exemple, dans 
<code javascript>
thisMovie("iep").set_iep("CrayonIep.crayon","_visible","true");
thisMovie("iep").set_iep("CrayonIep.crayon","_visible",true);
</code>
seule la deuxième ligne est correcte.

===== Exécuter une fonction =====
La fonction javascript permettant d'appeler une fonction d'instrumenpoche est :
<code javascript>
exec_iep(fonction,paramètres)
</code>
où ''fonction'' est un texte désignant la fonction et ''paramètres'' un tableau donnant les paramètres à passer à cette fonction. Il faut donner un tableau même si la fonction ne demande qu'un seul paramètre.

**Exemple**
<code javascript>
thisMovie("iep").exec_iep("UtilitairesIep.alerte",["ok"])
</code>
utilise la fonction d'affichage de messages interne à instrumenpoche pour afficher "ok".

**Autre exemple**
<code javascript>
thisMovie("iep").exec_iep("ImagesIep.charger_image",
   ["http://upload.wikimedia.org/wikipedia/commons/thumb/8/88/Gaucho_in_action.jpg/800px-Gaucho_in_action.jpg",
   1])
</code>
charge une image dans instrumenpoche sans que cela modifie le script de l'animation.

===== Instrumenpoche chargé =====
Dès que iep.swf est complètement chargé, la fonction javascript ''iep_loaded()'' est appelée. Pour effectuer une opération juste après le chargement d'instrumenpoche, il suffit donc de définir dans la page HTML une fonction ''iep_loaded()'' qui exécutera les instructions voulues.

**Exemple**
<code javascript>
function iep_loaded(){    
   // j'annonce qu'instrumenpoche et complètement chargé
   alert("iep est chargé !");
}
</code>