[debutant] equivalent Whatthis sous swing

Version imprimable

12/06/2006, 09h48
albmi

[debutant] equivalent Whatthis sous swing

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
12/06/2006, 11h17
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
12/06/2006, 12h35
albmi

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

Merci
Ami
12/06/2006, 15h05
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.
13/06/2006, 00h21
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...).
13/06/2006, 15h09
albmi

Citation:

Envoyé par 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...

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

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

Ami

Citation:

Envoyé par albmi

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:

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.

14/06/2006, 08h30
albmi

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