Utilisation de l'aide en ligne de JBuilder

JBuilder affiche les rubriques d'aide en ligne dans le visualiseur d'aide. Les rubriques peuvent aussi être affichées dans l'AppBrowser ou dans un navigateur web.

Visualiseur d'aide de JBuilder

Choisissez l'une des rubriques suivantes pour plus d'informations sur le système d'aide de JBuilder :

Comment obtenir de l'aide

Il existe plusieurs moyens d'obtenir de l'aide sur toutes les rubriques :

Les parties principales du visualiseur d'aide

Le visualiseur d'aide de JBuilder comprend les éléments suivants :

Utilisation du visualiseur d'aide

Choisissez l'une des rubriques suivantes pour obtenir des informations sur le visualiseur d'aide :

Utilisation du sommaire

Pour choisir une rubrique dans le sommaire :

  1. Cliquez sur l'onglet Sommaire, en haut et à gauche du visualiseur d'aide.
  2. Double-cliquez sur l'icône d'un livre pour développer les rubriques qu'il contient.
  3. Cliquez sur une rubrique du sommaire pour voir cette rubrique dans le volet Contenu.

Utilisation de l'index

Pour trouver une rubrique dans l'index :

  1. Cliquez sur l'onglet Index, en haut et à gauche du visualiseur d'aide.
  2. Tapez la rubrique dans le champ texte.
    Au fur et à mesure que vous tapez, l'index défile en faisant une recherche incrémentale dans les entrées de l'index pour trouver la correspondance la plus proche.
  3. Double-cliquez sur la rubrique en surbrillance dans l'index, ou appuyez sur Entrée, pour faire apparaître son contenu.
    S'il y a plusieurs rubriques pour l'entrée d'index sélectionnée, le volet d'index se divise et affiche la liste des rubriques dans sa partie inférieure. Cliquez sur la rubrique que vous voulez afficher.

Utilisation de la recherche de texte globale (y compris les recherches booléennes)

Pour rechercher du texte dans tous les manuels et utiliser la recherche booléenne :

  1. Cliquez sur l'onglet Chercher, en haut et à gauche du visualiseur d'aide.
  2. Saisissez les mots recherchés dans le champ texte.
    Au fur et à mesure que vous tapez, la liste des mots défile et montre les termes les plus proches.

    Le visualiseur d'aide supporte les opérations de recherche booléennes suivantes :
    (N'utilisez pas de guillemets dans le champ texte.)
  3. Double-cliquez sur la rubrique en surbrillance, ou appuyez sur Entrée, pour faire apparaître son contenu.
    S'il y a plusieurs rubriques pour l'entrée sélectionnée, le volet Chercher se divise et affiche la liste des rubriques dans sa partie inférieure. Cliquez sur la rubrique que vous voulez afficher.

Recherche de texte dans la rubrique en cours

Pour chercher du texte dans la rubrique en cours dans le visualiseur d'aide :

  1. Cliquez sur le bouton Chercher Chercher dans le visualiseur d'aide ou appuyez sur Ctrl + f.
  2. Tapez les mots recherchés dans le dialogue Chercher le texte dans la rubrique en cours.
  3. Cliquez sur Chercher le suivant ou appuyez sur Entrée si vous voulez poursuivre la recherche.
  4. Cliquez sur Annuler pour fermer la boîte de dialogue.
  5. Appuyez sur F3 pour reprendre la recherche sans ouvrir la boîte de dialogue.

Copie de texte depuis le visualiseur d'aide

Pour copier du texte sélectionné depuis le visualiseur d'aide :

  1. Sélectionnez le texte dans le volet Contenu.
  2. Sélectionnez Edition|Copier dans le menu principal du visualiseur d'aide, ou appuyez sur Ctrl + c.

Zoom dans le visualiseur d'aide

Vous pouvez changer la taille apparente de la police et des images dans le visualiseur d'aide en faisant des zooms avant et arrière. Vous pouvez ainsi examiner de plus près les images, mettre davantage de texte à la fois dans la fenêtre ou ajuster la vue pour votre confort. Les incréments du zoom sont petits, ce qui vous permet de contrôler avec précision la taille apparente de la vue.

Il y a deux façons d'effectuer chaque type de zoom :

Pour un zoom avant :

Pour un zoom arrière :

Pour revenir à la vue normale :

Utilisation des signets

Pour ajouter un signet sur la page en cours dans le visualiseur d'aide, sélectionnez Signets|Ajouter un signet dans le menu principal.

Pour modifier des signets dans le visualiseur d'aide :

  1. Sélectionnez Signets|Modifier les signets dans le menu principal. La boîte de dialogue Editeur de signets s'ouvre.
  2. Sélectionnez le signet et cliquez sur l'option permettant de retirer un signet, de réorganiser un signet ou d'aller à un signet.
  3. Cliquez sur Fermer.

Pour aller sur un signet, sélectionnez Signets et choisissez un signet dans la liste. Les dix premiers signets sont associés à des mnémoniques dans le menu Signets. Il vous faut donc placer les signets les plus souvent utilisés début de liste. Le nombre de signets figurant dans le menu est limité à 25 mais vous pouvez modifier le fichier help.properties afin d'augmenter cette valeur. Le fichier help.properties est créé la première fois que vous quittez le visualiseur d'aide ; il est enregistré dans le répertoire .jbuilder dépendant de votre répertoire home.

Navigation dans le visualiseur d'aide

Le tableau suivant décrit comment vous déplacer dans le visualiseur d'aide :

Pour Faites ceci... Raccourcis clavier
Changer de manuel ou aller à une rubrique Cliquez sur le titre de la rubrique. Utilisez les touches fléchées.
Développer ou réduire une section du sommaire Cliquez sur l'icône située à côté de la rubrique, dans la page Sommaire ou double-cliquez sur la rubrique. Sélectionnez le manuel et appuyez sur Entrée pour l'ouvrir.
Vous pouvez aussi sélectionner le manuel et utiliser les flèches Droite et Gauche pour ouvrir et fermer le manuel.
Revenir à la rubrique précédente de l'historique Cliquez sur le bouton Précédent Précédent. Ctrl+Gauche
Aller à la rubrique suivante de l'historique Cliquez sur le bouton Suivant Suivant. Ctrl+Droite
Aller à la première rubrique de l'historique Cliquez sur le bouton Début Début. Ctrl+Origine
Chercher du texte dans la rubrique en cours Cliquez sur le bouton Chercher Chercher . Ctrl+F
Rechercher une nouvelle occurrence     F3
Chercher du texte dans tous les manuels Cliquez sur l'onglet Chercher.    
Suivre un lien hypertexte souligné dans le texte Cliquez sur le lien dans le texte.    


Défilement à l'aide du clavier

Quand vous sélectionnez une entrée dans les pages Sommaire, Index ou Chercher du visualiseur d'aide, la focalisation du clavier suit. Les touches de navigation (comme la touche Pg. Suiv.) permettent le défilement dans le côté gauche du visualiseur d'aide et non dans le volet Contenu.

Pour placer la focalisation dans le volet Contenu, à droite, appuyez sur la touche Tab. La touche Tab fait tourner la focalisation du volet sélectionné à gauche du visualiseur d'aide (Sommaire, Index ou Chercher) au volet Contenu et ensuite aux boutons de navigation. Appuyez sur Maj+Tab pour changer de sens.

Affichage de la documentation de référence sur les classes

Vous pouvez voir la documentation de la référence pour une classe dans la fenêtre de l'AppBrowser, dans le visualiseur d'aide ou dans un navigateur web.

Pour afficher la documentation de référence dans l'AppBrowser, effectuez une des opérations suivantes :

Pour pouvoir trouver la documentation sur une classe, les instructions import du début du code source doivent mentionner la classe ou le paquet concerné. Si le message Symbole Java introuvable s'affiche, naviguez jusqu'à un fichier source qui importe la classe voulue.

Pour afficher les guides de référence dans le visualiseur d'aide, effectuez une des opérations suivantes :

Disposition des pages de la documentation de référence

Chaque entrée de la documentation de référence mise en place par Borland montre non seulement les méthodes et les champs (variables) définis dans la classe ou interface, mais aussi ceux dont elle a hérité. Ces listes de méthodes et de champs disponibles vous permettent d'accéder directement à la documentation les concernant.

La page de la documentation de référence pour une classe, un composant ou une interface est constituée des sections suivantes :

Recherche de propriétés dans la documentation de référence

Des propriétés simples sont listées dans la section Propriétés de chaque fichier de la documentation de référence. Une propriété simple est une propriété pour laquelle la méthode d'accès en écriture ("setter"), s'il y en a une, prend un seul paramètre et ne renvoie aucune valeur. S'il y a une méthode d'accès en lecture (commençant par "get" ou "is"), elle ne prend aucun paramètre et renvoie une valeur.

Vous pouvez rechercher les propriétés simples dans l'index du visualiseur d'aide en utilisant soit le nom complet de la propriété soit son nom "court" (sans le préfixe "get", "set" ou "is"). Par exemple, vous trouverez la propriété border du composant BorderIcon avec chacune des entrées d'index suivantes :

getBorder, ButtonIcon, composant
setBorder, ButtonIcon, composant
border,  ButtonIcon, composant

Dans de nombreux cas, il existe des méthodes qui ne suivent pas les règles des propriétés simples, mais qui manipulent néanmoins une propriété. Souvent, ces méthodes supplémentaires complètent les fonctionnalités des propriétés simples correspondantes. On les trouve dans la section Méthodes du fichier classe, sous le nom complet de la méthode, là où elles sont disponibles. Dans l'index du visualiseur d'aide, ces méthodes figurent avec leur nom complet.

Impression des tutoriels et du reste de la documentation

Pour imprimer les tutoriels et le reste de la documentation de JBuilder, ouvrez la documentation dans le visualiseur d'aide et sélectionnez Fichier|Imprimer. La documentation est également fournie au format PDF sur votre CD.

Manuels et tutoriels au format PDF

Nom du manuel Nom du tutoriel Nom du fichier PDF
Prise en main Construction d'une application qs.pdf
   Construction d'une applet qs.pdf
Introduction à Java    gsjava.pdf
Construction d'applications avec JBuilder Exécution, compilation et débogage pg.pdf
   Construction d'un éditeur de texte Java pg.pdf
   Création d'une interface utilisateur ayant des dispositions imbriquées pg.pdf
  GridBagLayout pg.pdf
Guide du développeur d'applications bases de données    database.pdf
Guide du développeur JDataStore   jdspg.pdf
Développement en équipe en utilisant JBuilder    teamdev.pdf
Guide du développeur d'applications web Création d'un servlet simple webapp.pdf
   Création d'un servlet qui met à jour un guestbook webapp.pdf
   Création d'une JSP webapp.pdf
   Création d'un servlet avec InternetBeans Express webapp.pdf
   Création d'une JSP avec InternetBeans Express webapp.pdf
   Exécution de l'application exemple CheckBoxControl avec Web Start webapp.pdf
Guide du développeur Enterprise JavaBeans    enterprisejb.pdf
Guide du développeur d'applications XML    xml.pdf
Guide du développeur d'applications distribuées Création d'une application CORBA dans JBuilder distributed.pdf
  Création d'une application distribuée basée sur RMI Java dans JBuilder distributed.pdf
  Débogage distant distributed.pdf
Développement OpenTools    opentools.pdf