Emettre un signal

Avatar de Monsieur X
Description du chapitre et des ses objectifs :

On peut bien sur utiliser les signaux existants, mais ça peut-être intéressant d'émettre des signaux entre ses propres objets.

Heureusement pour nous, avec Qt Jambi c'est très facile.
Voyez plutôt ...

Image de Partie

Accéder directement à une des parties du cours :

Qu'est-ce que c'est un signal ?

Un signal c'est un Objet qui est défini comme attribut public d'une classe. (c'est assez rare d'avoir un attribut public pour le préciser)

Cet objet contient deux méthodes publiques principales :

  • connect : Elle nous permet de connecter une méthode (slot) à ce signal
  • emit : Elle nous permet d'émettre un signal.

Un signal peut émettre avec lui des variables en Java entre 0 et 9 variables.
Le nom du signal dépend de ce nombre de variables que l'on veut envoyer.

Voici comment on ajoute un signal à notre classe :

Code java - Numéro de ligne
  1. public Signal1<Integer> valueChanged = new Signal1<Integer>();


Comme vous le comprendrez surement, ce signal émet avec lui un entier (Integer).
C'est le signal de LCDNumber.

Et voilà, un signal ce n'est rien de plus que ça.

Emettre un signal

Pour qu'un signal soit utile, il faut un jour ou l'autre l'émettre.
Cela veut dire qu'on active la connection avec le slot.

Autant se donner un but

Cahier des charges


On va commencer par créer un nouveau widget qui contiendra un champ de texte QLineEdit ainsi qu'un QLabel.

Notre objet, lorsque le texte du QLineEdit va être changé va émettre un signal.
Ainsi, il pourra modifier le texte d'une autre boite de dialog. (Un minichat entre deux dialog).

ça va ressembler à ça :
<image legende="Chat inter Dialog">uploads/fr/files/92001_93000/92134.png</image>


Étant donné que QLineEdit s'occupe déjà de nous envoyer un signal, on ne va faire que le retransmettre.

Code java - Numéro de ligne
  1. import com.trolltech.qt.gui.*;
  2.  
  3. public class DialogButton extends QDialog {
  4.         private QLabel text;
  5.        
  6.         public final Signal1<String> configured = new Signal1<String>();
  7.        
  8.         public DialogButton(String titre){
  9.                 QLabel label = new QLabel(tr("Entrez votre message:"));
  10.                 QLineEdit lineEdit = new QLineEdit();
  11.                 text = new QLabel();
  12.                 QVBoxLayout layout = new QVBoxLayout( this );
  13.                 layout.addWidget(label);
  14.                 layout.addWidget(lineEdit);
  15.                 layout.addWidget(text);
  16.                 setLayout(layout);
  17.                 setWindowTitle(titre);
  18.                 lineEdit.textChanged.connect(this, "emit(String)");
  19.         }
  20.        
  21.         public void emit(String s){
  22.                 configured.emit(s);    
  23.         }
  24.        
  25.         public void write(String lineEditText){
  26.                 if(text.text() != lineEditText){
  27.                         text.setText(lineEditText);    
  28.                 }
  29.         }
  30.        
  31.         public static void main(String[] args){
  32.                 QApplication.initialize(args);
  33.                 DialogButton app = new DialogButton("Dialog 1");
  34.                 DialogButton ap2 = new DialogButton("Dialog 2");
  35.                 app.configured.connect(ap2, "write(String)");
  36.                 ap2.configured.connect(app, "write(String)");
  37.                 app.show();
  38.                 ap2.show();
  39.                 QApplication.exec();
  40.         }      
  41. }


Regardons de plus prêt :

Code java - Numéro de ligne
  1. public final Signal1<String> configured = new Signal1<String>();

On ajoute un signal configured à notre widget qui va émettre avec lui une chaine de caractères.
Cette chaine sera le contenu du LineEdit.

Code java - Numéro de ligne
  1. lineEdit.textChanged.connect(this, "emit(String)");

Ici on connecte le signal reçu du lineEdit quand le texte a changé avec notre méthode emit qui va émettre notre signal.

Code java - Numéro de ligne
  1. public void emit(String s){
  2.       configured.emit(s);    
  3. }


Notre méthode emit() va seulement émettre notre signal configured.

Code java - Numéro de ligne
  1. public void write(String lineEditText){
  2.        if(text.text() != lineEditText){
  3.                 text.setText(lineEditText);    
  4.        }
  5. }

Dans notre méthode write, on vérifie que le texte a bien changé.
C'est une simple précaution pour éviter des boucles qui pourraient provoquer des scintillements de l'interface ou une augmentation indésirable de l'activité du processeur.

On ne sait en effet pas quels sont les mécanismes mis en place par la méthode setText. Donc par précaution, (surement inutile dans ce cas) on évite des calculs inutiles.

Dans notre méthode main, on crée des boites de dialogue que l'on nomme pour les différencier.
On connecte le signal de l'une avec la méthode write de l'autre et vice-versa.

Maintenant, il est temps de tester.

Petit exercice

Énoncé de l'exercice



Citation :
En reprenant le résultat de l'exercice précédent, on souhaite, lorsqu'on modifie un slider, modifier les états de tous les sliders précédents.


Résultat Attendu



<image legende="Un signal récursif ...">uploads/fr/files/92001_93000/92136.png</image>


Question subsidiaire :



Citation :
Définir l'ordre dans lequel ont été modifiés les sliders de la boite de dialogue du screenshot.
Pour cela on numérotera les sliders ainsi (0,0) pour le premier et (0,1) pour le deuxième, ... (2,0) pour le premier de la troisième ligne


Secret (cliquez pour afficher)
Le premier à avoir été modifié est le slider(2,2). Il est à 68 et a donc modifié tous les autres à 68.
Le deuxième est le slider(2,1) il est à 46 et à modifié tous les précédents à cette même valeur.
Le troisième est le slider(1,1) de même il a mis tous les précédents à 57.
Le quatrième et dernier et les slider(0,0) qui est à 73.


Solution



Secret (cliquez pour afficher)
La solution (si jamais vous en aviez besoin) se trouve dans les sources de qtjambi.
(com/trolltech/examples/tutorial/ConnectedSliders.java)

...

Chapitre précédent - Sommaire

Nos rédacteurs et membres sont pour la plupart ouverts à des remarques constructives et servir à alerter le rédacteur du cours, des fautes éventuelles ou de propositions et nouvelles perspectives de cours etc ...
Pour ce faire cliquez ici

Postez vous aussi un commentaire à cette partie via le lien que voici