Guide de référence de Lotus BeanMachine

Ajout d'un composant applet

Ajout d'un composant applet
Vous allez apprendre à ajouter une applet. Vous pouvez créer votre applet ou en télécharger une sur le Web. Quel que soit le mode utilisé, l'importation d'une applet dans BeanMachine est un jeu d'enfants.

Sachez que si vous téléchargez une classe Java qui n'est pas de type JAR, cette classe doit se trouver dans un répertoire du chemin d'accès spécifique des classes (CLASSPATH) pour être reconnu par l'Assistant BeanMachine. Pour vous simplifier la tâche, placez le fichier de classe que vous souhaitez importer dans le dossier "Beans" de BeanMachine. Pendant l'installation de BeanMachine, votre chemin d'accès de classe est modifié et le dossier "Beans" est créé. Ainsi, l'Assistant BeanMachine peut accéder à toutes les classes copiées automatiquement.

Passons aux exercices. Pour importer un nouveau composant ou objet Bean, démarrez l'Assistant BeanMachine dans le menu déroulant Options. Sur l'onglet Bienvenue de l'assistant, sélectionnez "Créer un nouveau composant" puis entrez le nom de la classe à importer (nous verrons par la suite comment modifier un composant sur la palette de BeanMachine). N'oubliez pas que la classe que vous importez peut être n'importe quelle classe Java, notamment des applets ou autres types de classes Java. Si la classe fait partie d'un ensemble, vous devez entrer le nom complet de la classe (ex : java.awt.Button).

Pour illustrer notre exemple, nous avons choisi une applet que vous allez manipuler. Entrez le nom de classe suivant :

Fireworks

Fireworks est une classe Java qui se trouve dans le dossier "Beans" de BeanMachine. Lorsque vous créez un nouveau composant avec l'Assistant BeanMachine, le programme crée automatiquement un fichier JAR correspondant.



Cliquez sur Suivant pour continuer.

Après le chargement du fichier de classe, l'onglet Palette s'affiche. L'onglet Palette de l'assistant vous permet d'attribuer un nom à votre nouveau composant, un texte descriptif et de choisir une catégorie sur la palette de BeanMachine. Vous pouvez ajouter votre nouveau composant dans n'importe quelle catégorie existante de BeanMachine, ou créer une nouvelle catégorie, comme Effets spéciaux ou Mes composants. En outre, l'onglet Palette permet d'associer une icône à votre nouveau composant. Vous pouvez choisir cette icône parmi les exemples fournis ou utiliser une image au format GIF ou JPEG. Vous pouvez également sélectionner fireworks.gif dans la liste.

Cochez la case "Ce composant accepte les enfants" si le nouveau composant que vous importez peut incorporer lui-même d'autres composants. Par défaut, la plupart des composants n'offrent pas cette possibilité. Cette option reste donc la plupart du temps désactivée. Cependant, si vous importez un composant qui accepte des sous-composants, comme un panneau, et si vous souhaitez offrir à l'utilisateur la possibilité d'y insérer d'autres composants, activez cette option.



Cliquez sur Suivant pour continuer.

L'onglet suivant intitulé Applet permet de définir les noms et les valeurs par défaut de tous les paramètres possibles de votre applet.




L'applet Fireworks comporte un paramètre, la vitesse. Comme le nombre 10 est une valeur par défaut qui semble convenable, sélectionnez "speed" dans la liste et cliquez sur Edition pour saisir la valeur. Pour accéder aux fonctions, propriétés et événements de votre nouveau composant, activez l'option "Activer les paramètres d'applet avancés".



Une fois que vous avez entré la valeur 10 pour définir la vitesse, cliquez sur OK, puis sur Suivant dans l'Assistant BeanMachine pour continuer.

L'onglet suivant Publier permet de visualiser le fichier JAR qui sera créé à la fin lorsque vous cliquerez sur le bouton Terminer. Cet onglet permet de modifier le fichier JAR en ajoutant, renommant et/ou supprimant les fichiers supplémentaires requis par votre nouveau composant. Si le fichier Fireworks.class n'est pas activé, cliquez dessus.

Les fichiers cochés seront intégrés à votre composant lorsque vous publierez votre applet avec BeanMachine. Assurez-vous que tous les fichiers requis par votre nouveau composant sont cochés pour assurer une exécution correcte de l'applet une fois publiée.



Cliquez sur Suivant pour continuer.

L'onglet suivant Migrer permet de compléter des informations nécessaires à BeanMachine pour ouvrir les applets (fichiers .app) qui contiennent des versions antérieures de votre composant. Normalement, vous n'aurez pas à utiliser cet onglet. Pour plus d'informations sur l'onglet Migrer, reportez-vous à la section Mise à niveau des composants.

Cliquez sur Terminer pour lancer la création de votre nouveau composant.



BeanMachine importe alors votre nouveau composant Fireworks et le place sur la palette dans la catégorie précédemment spécifiée. Maintenant, redémarrez BeanMachine pour tester le nouveau composant.

Pour tester votre nouveau composant Fireworks, placez-le sur le canevas de l'applet et modifiez les attributs de taille et de position en choisissant la valeur 200 pour la largeur et 100 pour la hauteur. Cliquez sur Exécuter pour visualiser le feu d'artifice. Remarque : seuls les applets compatibles avec Netscape Navigator version 2.0 ou ultérieure, ou Internet Explorer version 3.0 ou ultérieure, peuvent être importées.

Pour plus d'informations sur la personnalisation de la palette de BeanMachine, reportez-vous aux sections suivantes :

Ajout d'un objet JavaBean

Ajout d'autres composants Java

Personnalisation des composants