Serge NOEL
146 lines
8.5 KiB
Plaintext
146 lines
8.5 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="fr">
|
|
<!-- Translated by Blorec Hervé 2016-08-13-->
|
|
<head>
|
|
<title>Using the NetBeans Swing GUI Builder </title>
|
|
<meta name="author" content="Bob Jacobsen">
|
|
<meta name="keywords" content="JMRI technical code NetBeans">
|
|
<!--#include virtual="/help/fr/parts/Style.shtml" -->
|
|
</head>
|
|
|
|
<body>
|
|
<!--#include virtual="/help/fr/parts/Header_fr.shtml" -->
|
|
<div id="mBody">
|
|
<!--#include virtual="Sidebar.shtml" -->
|
|
<div id="mainContent">
|
|
<!-- Page Body -->
|
|
|
|
<!-- - - - - - - - - -->
|
|
<p> Des morceaux de code de l'Interface Graphique Utilisateur ( GUI ) de JMRI sont maintenus
|
|
par l'utilisation de
|
|
<a href="https://netbeans.org/features/java/swing.html">NetBeans Swing GUI Builder</a>
|
|
( le "Builder" ). cette page est un guide pour l'utilisation de l'outil Builder. Voir
|
|
<a href="NetBeans.shtml">Construire avec NetBeans</a> pour une introduction
|
|
générale de l'utilisation de NetBeans pour la maintenance de JMRI.</p>
|
|
<!-- - - - - - - - - -->
|
|
|
|
<h1>Utilisation du NetBeans Swing GUI Builder</h1>
|
|
|
|
<ul>
|
|
<li><a href="#intro">Introduction</a></li>
|
|
<li><a href="#usage">Utilisation de Builder</a></li>
|
|
<li><a href="#code">Examen du Code</a>
|
|
<ul>
|
|
<li><a href="#java">.java File</a></li>
|
|
<li><a href="#form">.form File</a></li>
|
|
</ul></li>
|
|
<li><a href="#references">Voir Aussi</a></li>
|
|
</ul>
|
|
<h2><a id="intro">Introduction</a></h2>
|
|
<p>NetBeans 7.4 ou 8.0 inclut un Swing GUI Builder qui rend plus aisé
|
|
la maintenance d'un Java Swing-based GUI (tel que JMRI ) que l'écriture
|
|
de l'interface utilisateur entièrement à la main.</p>
|
|
<p>Cet outil peut créer du code qui n'est pas idéalement séparé en code Java
|
|
généré et maintenu par l'homme. Si vous utilisez Netbeans, vous êtes protégé de
|
|
ceci, car le Builder réalise une bonne intégration de ses affichages avec
|
|
l'éditeur de source. Cependant, si vous utilisez un autre éditeur, vous y
|
|
serez exposé.</p>
|
|
|
|
<h2><a id="usage">Utilisation de Builder</a></h2>
|
|
|
|
<p>La barre d'outil de l'éditeur NetBeans contiendra automatiquement un bouton
|
|
<strong>Design</strong> si la Classe devant être éditée peut aussi être
|
|
éditée dans le Swing GUI Builder.</p>
|
|
<p>Cliquer sur le bouton <strong>Design</strong> donnera la possibilité
|
|
de glisser les boutons, labels, panneaux et autres objets sur une fenêtre
|
|
pour les placer visuellement. Tout objet conforme au standard
|
|
<a href="http://www.oracle.com/technetwork/java/javase/documentation/spec-136004.html">JavaBean</a>
|
|
peut être placé sur la fenêtre et lié à d'autres objets sur
|
|
cette fenêtre, même s'il n'a pas de représentation visuelle.</p>
|
|
<p>Où le Builder ne peut pas généré automatiquement du code, il fournit
|
|
des méthodes vides, ou tronquées, qui peuvent être complétées pour mettre en œuvre
|
|
la logique souhaitée, et passe automatiquement à l'affichage du code au besoin.</p>
|
|
|
|
|
|
<h2><a id="code">Examen du Code</a></h2>
|
|
<p>Le Builder maintient deux fichiers: un fichier.java contenant le code compilable,
|
|
et un fichier .form, contenant une représentation XMLde l'interface graphique avec
|
|
le code qui est utilisé pour créer la méthode initComponents() dans le fichier .java.
|
|
|
|
<h3><a href="java">Fichier .java</a></h3>
|
|
<p>Dans NetBeans, le code généré par le Builder, ressemble à n'importe
|
|
quel autre code java, mais des portions ne peuvent pas être modifiées ( simplement NetBeans
|
|
n'autorise pas le changement du code ). Des bouts de méthodes
|
|
seront modifiables, cependant, il ne sera pas possible de changer les signatures
|
|
de méthode ( nom, paramètres, valeurs retournées, ou throws clauses ).</p>
|
|
<p>Une méthode, <code>private void initComponents()</code>
|
|
<p>D'autre outils, cependant, afficheront le code de façon très différente, et
|
|
Code contiendra les marques non-standards suivantes, bien que valides,
|
|
comme les commentaires qui sont cachés dans NetBeans: </p>
|
|
<dl>
|
|
<dt>// <editor-fold defaultstate="collapsed" desc="Generated Code"></dt>
|
|
<dd>Masquer tout entre elle et
|
|
<code>// </editor-fold></code> avec la description
|
|
<em>Generated Code</em> dans NetBeans et autres éditeurs qui
|
|
le reconnaissent. Le code entre cess deux commentaires peut être affiché
|
|
en cliquant l'icône <strong>+</strong> à gauche de la description dans ces
|
|
éditeurs. C'est utilisé pour cacher le code qui ne devrait pas être
|
|
modifié manuellement.</dd>
|
|
<dt>// </editor-fold></dt>
|
|
<dd>Utilisé avec
|
|
<code>// <editor-fold defaultstate="collapsed" desc="Generated Code"></code>.
|
|
Voir la description commentaire pour plus d'informations.</dd>
|
|
<dt>//GEN-BEGIN:<em><token></em></dt>
|
|
<dd>Précède une méthode ou un bloc de variable qui est
|
|
entiérement généré par le Builder. Une telle méthode ou bloc est
|
|
suivi d'un
|
|
<code>//GEN-END:<em><token></em></code>commentaire correspondant.</dd>
|
|
<dt>//GEN-END:<em><token></em></dt>
|
|
<dd>Suit une méthode ou un bloc de variable qui est
|
|
entiérement généré par le Builder. Une telle méthode ou bloc est
|
|
précédé d'un
|
|
<code>//GEN-BEGIN:<em><token></em></code>commentaire correspondant.</dd>
|
|
<dt>//GEN-FIRST:<em><token></em></dt>
|
|
<dd>Précède une méthode qui génère du code appelé, mais le contenu
|
|
de celui-ci est écrit par un développeur. Une telle méthode est suivi
|
|
par un <code>//GEN-LAST:<em><token></em></code> commentaire
|
|
correspondant. Le signe est souvent
|
|
<code>event_<em><methodName></em></code>.</dd>
|
|
<dt>//GEN-LAST:<em><token></em></dt>
|
|
<dd>Suit une méthode qui génère du code appelé, mais le contenu
|
|
de celui-ci est écrit par un développeur. Ce commentaire marque l'accolade
|
|
fermante dans la méthode précédée
|
|
par un <code>//GEN-FIRST:<em><token></em></code>commentaire
|
|
correspondant.</dd>
|
|
</dl>
|
|
|
|
<h3><a href="form">Fichier .form</a></h3>
|
|
<p>Le fichier .form est entièrement caché au sein d'un IDE NetBeans.L'ouverture
|
|
d'un fichier .java avec son fichier correspondaznt .form ( le même nom de
|
|
fichier dans le même paquet ) ajoutera le bouton <strong>Design</strong> à la
|
|
baree d'outil de l'éditeur, permettant au Builder d'être utilisé.</p>
|
|
<p>Le fichier .form est un fichier XML adhérant à la DTD dans
|
|
<a href="http://hg.netbeans.org/core-main/file/tip/form/src/org/netbeans/modules/form/forminfo/forms.dtd">le code source NetBeans</a>
|
|
( lié à la tête de l'arbre NetBeans ). NetBeans utilise ce fichier
|
|
pour stocker des informations supplémentaires en dehors de la spécification
|
|
JavaBeans ce qui est nécessaire pour générer correctement la méthode
|
|
<code>initComponents()</code>, des bouts de méthodes et des listes de
|
|
variables. En absence d'autres changements dans le fichier .java, ce fichier
|
|
pourra être utilisé pour générer entièrement un neouveau fichier. java, si cela
|
|
est nécessaire.</p>
|
|
<p>Ce fichier ne devrait pas être modifié à la main, mais devrait être généré par
|
|
le Builder.</p>
|
|
|
|
<h2><a id="references">Voir aussi</a></h2>
|
|
<ul>
|
|
<li><a href="https://netbeans.org/kb/docs/java/quickstart-gui.html">Designing a Swing GUI in NetBeans IDE</a></li>
|
|
<li><a href="https://netbeans.org/kb/trails/matisse.html">Java GUI Applications Learning Trail</a></li>
|
|
</ul>
|
|
|
|
<!--#include virtual="/help/fr/parts/Footer_fr.shtml" -->
|
|
</div><!-- closes #mainContent-->
|
|
</div>
|
|
<script src="/js/help.js"></script>
|
|
</body>
|
|
</html>
|