IWCLink : Afficher une URL dans un navigateur ou cadre

Comment :

La fonction IWCLink affiche une URL dans une nouvelle fenêtre de navigateur ou dans un cadre au sein de votre formulaire actuel. Vous pouvez utiliser IWCLink dans le cadre d'une technique qui vous permet d'invoquer une procédure externe sans la commande EXEC.


Haut de page

x
Syntaxe : Afficher une URL dans un navigateur ou cadre
IWCLink(url, [target], [newwindow], [options])

où :

url

est l'URL de la page web à afficher.

target

est la fenêtre ou le cadre vers lequel envoyer la requête d'URL.

newwindow

détermine si l'URL apparaît dans une nouvelle fenêtre du navigateur. Lorsque ce paramètre est différent de zéro ou vrai, une nouvelle fenêtre de navigateur est créée.

options

sont de nouveaux paramètres de fenêtre. Ceci comprend, mais n'est pas limité aux éléments suivants :

  • screenX=distance, qui est la distance à laquelle la nouvelle fenêtre est placée du côté gauche de l'écran.
  • screenY=distance, qui est la distance à laquelle la nouvelle fenêtre est placée du côté supérieur de l'écran.
  • scrollbars={yes|no}, qui détermine si les barres de défilement horizontales et verticales sont créées lorsque le document dépasse les dimensions de la fenêtre. Lorsqu'il est réglé sur oui, les barres de défilement sont créées. Lorsqu'il est réglé sur non, les barres de défilement ne sont pas créées.
  • status={yes|no}, qui détermine si une barre d'état apparaît au bas de la fenêtre. Lorsqu'il est réglé sur oui, une barre d'état est créée. Lorsqu'il est réglé sur non, une barre d'état n'est pas créée.
  • titlebar={yes|no}, qui détermine si une barre de titre apparaît au bas de la fenêtre. Lorsqu'il est réglé sur oui, une barre de titre est créée. Lorsqu'il est réglé sur non, une barre de titre n'est pas créée.
  • toolbar={yes|no}, qui détermine si une barre d'outils standard du navigateur apparaît dans la fenêtre. Lorsqu'il est réglé sur oui, une barre d'outils est créée. Lorsqu'il est réglé sur non, une barre d'outils n'est pas créée.
  • height=pixels, qui est la hauteur de la fenêtre en pixels.
  • resizable={yes|no}, qui détermine si un utilisateur peut redimensionner la fenêtre. S'il est réglé sur oui, un utilisateur peut redimensionner la fenêtre. S'il est réglé sur non, un utilisateur ne peut pas redimensionner la fenêtre.


Exemple : Afficher une URL dans une cadre

Le code JavaScript suivant est appelé depuis un gestionnaire d'événements de script et utilise IWCLink dans le cadre d'une technique pour invoquer une procédure externe et fournir le paramètre de la procédure dynamiquement lors de l'exécution.

						1. var theReport = "http://172.19.81.107/ibi_apps/WFServlet?IBIF_focexec=rsales4&IBIF_parms=STCD%3D" 
						2. theReport = theReport + document.Form1.EditBox1.value;
						3. IWCLink(theReport,"MyFrame",0,menubar=no,resizable=no,scrollbars=no,
   status=no,toolbar=no,height=600,width=600");

Ces commandes accomplissent ce qui suit :

  1. Définit une variable nommée theReport et l'initialise à l'URL cible.

    Lorsque vous utilisez IWCLink dans le cadre d'une technique pour invoquer une procédure externe, l'URL cible doit identifier le script WebFOCUS (IPAddress/ibi_apps/WFServlet), la procédure cible externe (?IBIF_focexec=ProcedureName), et les paramètres de la procédure (&IBIF_parms=ParameterName%3D). Un nom de paramètre est le nom de la procédure cible correspondant à la variable du Gestionnaire de dialogue sans l'esperluette initiale. Notez que %3D est le code HTML pour un signe égal ; l'instruction suivante va ajouter la valeur du paramètre au signe égal.

    Dans ce cas, la procédure cible est nommée rsales4, et rsales4 contient un paramètre nommé STCD.

  2. Affecte une valeur à partir d'une zone d'édition (Form1.EditBox1) au paramètre STCD de la procédure cible en ajoutant la valeur à la chaîne d'URL dans theReport.
  3. Appelle IWCLink pour afficher une séance de reporting WebFOCUS, qui exécute la procédure rsales4 externe, dans le cadre nommé MyFrame.

    Si vous souhaitez que la séance de reporting apparaîsse dans une nouvelle fenêtre de navigateur, vous laisseriez le deuxième argument vide et changeriez le troisième argument de 0 à 1.

    Les autres arguments commençant par "barre de menus" personnalisent l'apparence de la fenêtre du navigateur ; pour des informations sur les paramètres du navigateur, consultez la documentation de votre navigateur.


WebFOCUS