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