Discussion :

[albmi]

J'essaye de trouver un équivalent au WhatThis : cette méthode consiste à afficher un curseur en forme de flêche avec un '?' ( via un raccourci clavier CTRL+F1). Si le client clique sur un objets (JButton, etc) alors s'affiche un bulle d'aide associé à l'objet (et plus complète qu'un simple tooltip).

Le WhatThis se différencie du tooltip : le tooltip s'affiche toujours quand le client passe la souris dessus, tandis que le WhatThis nécessite de passer d'abord dans ce mode ... avant d'afficher l'information associé.

Ca existe le WhatThis sous Java/Swing ?

Merci
Ami

[sinok]

Il va falloir te le farcir à la main, rien n'est fourni de base pour ceci.

Grosso modo, il te faut un bouton (ou un toggle) qui permet d'effectuer le changemenet d'état (typiquement une variable booléenne)
A ce moment tu change le curseur de ta souris avec la méthode setCursor de ta JFrame
Et puis ensuite amuse toi avec un mouseListener faisant apparaître une JWindow contenant ce que tu veux

[albmi]

Je ne trouvais rien a ce sujet. Bon je vais retirer cette possibilité dans l'application.

Merci
Ami

[xavlours]

Tu as aussi la méthode SwingUtilities.getDeepestComponentAt() qui, alliée à un GlassPane, peut être très utile.

Ensuite, en stockant les correspondances composant-action d'aide dans une map, ça ira tout seul.

Le plus gros du boulot, c'est surtout d'écrire l'aide. Le reste est quand même assez rapide.

[bouye]

Ce n'est pas tout a fait vrai, cette fonctionalite existe dans JavaHelp quoiqu'elle ne soit pas simple a mettre en place je trouve. En plus JavaHelp ne fait toujours pas partie des classe core (inadmissible quand le JRE est suppose etre la partie cliente et faire tourner des applications de bureau).

Il est alors possible de creer un objet implementant a la fois l'interface Action et etendant CSH.DisplayHelpAfterTracking (cette classe de JavaHelp implemente ActionListener) pour creer des boutons et aurtres menus d'aide contextuelle. Bon apres... il faut aussi se dem@#$#@ avec la maniere dont JavaHelp fonctionne (HelpSet, HelpBroker, help map, etc...).

[albmi]

Ce n'est pas tout a fait vrai, cette fonctionalite existe dans JavaHelp quoiqu'elle ne soit pas simple a mettre en place je trouve...

Si vous avez des exemples, moi BIG débutant, je suis intéressé avec ce que vous avez réussi à mettre en place.

Merci pour l'indice. Je vais réviser ma décision si je trouve des exemples.

Ami

[bouye]

moi BIG débutant

C'est bien, donc comme tous les etudiant tu as tout a fait l'habitude de lire de la documentation et de faire des recherches par toi meme. Voila qui va faciliter les choses........

Voici un exemple de squelette d'une telle action.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
import java.awt.*;
import java.awt.event.*;
import java.beans.*;
import java.util.*;
import javax.help.*;
import javax.swing.*;

/** Creates a context sensitive action. 
 * <br>Such action may be re-used to create buttons and menuitems.
 */
public class ContextHelpAction
      extends CSH.DisplayHelpAfterTracking implements Action {
    /** Map of values.
     */
    private java.util.Map<String, Object> propertyMap = new HashMap<String, Object>();

    /** Fire events.
     */
    private PropertyChangeSupport support = new PropertyChangeSupport(this);

    /** Creates a new instance.
     * @param broker The help broker.
     */
    public ContextHelpAction(HelpBroker broker) {
      super(broker);
      putValue("enabled", true);
      // We put an help topic onto this action as well.
      // Be careful though, this property may not be properly caried over to children buttons by the default action=>button configuration method.
      // We may need to do :
      // JButton child1 = toolBar.add(contextHelpAction);
      // child1.putClientProperty("HelpID", contextHelpAction.getValue("HelpID"));      
      // JMenuItem child2 = menu.add(contextHelpAction);
      // child2.putClientProperty("HelpID", contextHelpAction.getValue("HelpID"));
      putValue("HelpID", "HelpContextAction");
      // Configure action eg: put label, icon, tooltip, mnemonic, keystroke.
    }

    /** {@inheritDoc}
     */
    public void putValue(String key, Object value) {
      Object old = propertyMap.put(key, value);
      support.firePropertyChange(key, old, value);
    }

    /** {@inheritDoc}
     */
    public Object getValue(String key) {
      return propertyMap.get(key);
    }

    /** {@inheritDoc}
     */
    public boolean isEnabled() {
      return (Boolean) getValue("enabled");
    }

    /** {@inheritDoc}
     */
    public void setEnabled(boolean enabled) {
      putValue("enabled", enabled);
    }

    ///////////////////////
    // Event management. //
    ///////////////////////

    /** {@inheritDoc}
     */
    public void actionPerformed(ActionEvent event) {
      try {
        super.actionPerformed(event);
      }
      catch (Throwable t) {
        // Handle JavaHelp error.
      }
    }

    /** {@inheritDoc}
     */
    public void removePropertyChangeListener(PropertyChangeListener listener) {
      support.removePropertyChangeListener(listener);
    }

    /** {@inheritDoc}
     */
    public void addPropertyChangeListener(PropertyChangeListener listener) {
      support.addPropertyChangeListener(listener);
    }
}

Voir egalement HelpBroker.enableHelpKey(component, helpID, helpSet, presentation, title); pour activer l'aide via le button F1 sur un composant particulier.

Sinon le guide utilisateur de JavaHelp est accessible ici. C'est le chapitre 5.3 qui parle de l'aide contextuelle. Tout betement la valeur textuelle associee a la propriete "HelpID" est une clee de la help map (l'un des fichiers XML, avec le help set, que tu devras creer) permettant ainsi de trouver le fichier HTML sur le disque contenant le topic d'aide a afficher. Le HelpBroker est literralement le fournisseur d'aide c'est l'objet JavaHelp charger d'acceder aux fichiers de definitions du help set.

[albmi]

Au nom de tous les BIG débutants et de moi même : MERCI !
Bonne journée.
Ami