Apprendre à lire la documentation de Qt

• si vous avez internet : vous pouvez aller sur le site de Trolltech (l'entreprise qui édite Qt) ;
• si vous n'avez pas internet : vous pouvez utiliser le programme Qt Assistant qui contient toute la doc.

Avec internet : sur le site de Trolltech

Je vous conseille très fortement d'ajouter ce site dans vos favoris, et de faire en sorte qu'il soit visible !
Si vous ne faites pas un raccourci visible vers la doc, vous serez moins tentés d'y aller... or le but c'est justement que vous preniez le réflexe d'y aller

Sans internet : avec Qt Assistant

Getting Started

• What's new in Qt 4.x : qu'est-ce qu'il y a de nouveau dans votre version de Qt par rapport aux précédentes ? Cette page intéressera surtout ceux qui connaissent Qt depuis quelques temps et qui sont curieux de voir ce qui a été ajouté depuis les versions précédentes. Je vous conseille d'y jeter un oeil, c'est plutôt bien illustré et clair et ça vous donne une idée des fonctionnalités sur lesquelles Trolltech travaille.
• How to Learn Qt : comment apprendre Qt ? Cette page vous donnera une série de conseils pour apprendre Qt dans les meilleures conditions. On vous conseillera notamment de suivre un tutoriel (ils ne parlent pas des tutoriels du SdZ hélas ).
• Installation : comment installer Qt. A ce stade du cours vous devriez déjà l'avoir fait, donc ça ne devrait pas vous avoir posé de problème.
• Tutorial and Examples : le tutoriel officiel de Qt et une série de programmes d'exemple avec leur code source. C'est une section TRES intéressante, je vous recommande d'y jeter un oeil. J'ai moi-même débuté avec Qt grâce à leur tutoriel qui est bien fait. Ce tutoriel permet en revanche seulement de démarrer et n'ira pas autant dans le détail que le tutoriel du Site du Zéro. Lorsque vous serez un peu plus expérimentés, je vous recommande de regarder les programmes d'exemple aussi, à partir d'un moment on apprend beaucoup mieux en lisant le code source des programmes
• Porting from Qt 3 and Qt 4 : quels sont les changements majeurs entre Qt 3 et Qt 4 ? Il s'agit de 2 "grandes" versions de Qt très différentes. Cette section n'est destinée qu'aux anciens développeurs qui utilisaient Qt 3 et qui veulent passer à Qt 4. A priori, elle ne vous concerne donc absolument pas. Allez zou, on passe !

General

Developer Resources

API Reference

• All Classes : affiche TOUTES les classes de Qt, triées par ordre alphabétique. Notez que comme toutes les classes de Qt commencent par la lettre Q, on considère que c'est la seconde lettre qui détermine l'ordre alphabétique. Ainsi, QWidget se trouvera dans la section de la lettre "W".
• Main Classes : c'est une version épurée de "All Classes" qui ne contient que les classes les plus fréquemment utilisées. Je vous conseille de commencer par cette section, amplement suffisante dans un premier temps. Inutile de vous assommer directement avec la liste de toutes les classes
• Grouped Classes : ici, les classes sont groupées par thèmes. C'est une section TRES intéressante pour vous qui débutez. Justement, si vous recherchez une classe dont vous ne connaissez pas le nom, c'est là qu'il faut aller.
• Annotated Classes : contient toutes les classes (comme All Classes) mais avec une courte description devant chacune d'elles. C'est pratique pour retrouver une classe, mais pas autant que la section "Grouped Classes" dont je viens de vous parler
• Qt Classes by Module : les classes sont triées suivant les grands modules de Qt. Comme je vous l'avais dit, nous nous intéresserons surtout au plus gros module dédié à la création d'interfaces graphiques, à savoir QtGui.
• Inheritance Hierarchy : hiérarchie des classes sous forme de liste à puces. On peut voir qui hérite de qui, qui est le "parent" de qui. Ce n'est pas très exploitable à mon avis, je vous conseille de voir le "Class Chart" (plus bas).
• All Functions : liste toutes les fonctions (méthodes) utilisées par toutes les classes de Qt. A utiliser si vous vous souvenez du nom d'une fonction mais pas du nom de la classe.
• Qtopia Core : documentation de la version "light" de Qt destinée aux appareils mobiles (téléphones portables par exemple). Ca ne nous intéresse pas ici.
• All Overviews and HOWTOs : liste de tous les articles de la doc de Qt. Il y a beaucoup de choses dedans et c'est un peu fouilli et inexploitable si vous voulez mon avis, vous pouvez accéder à ces articles par d'autres moyens plus "logiques" depuis l'accueil de la doc.
• Qt Widget Gallery : une galerie des principaux widgets de Qt. Vous pouvez comparer l'apparence des widgets en fonction des systèmes d'exploitation. Si vous cliquez par exemple sur "Windows Vista Style Widget Gallery", vous aurez un très bon aperçu de la plupart des widgets que Qt propose (avec des captures d'écran faites sous Vista). Je vous rappelle que tous ces widgets fonctionnent sur tous les autres OS, c'est juste l'apparence qui change à chaque fois.
• Class Chart : un diagramme de toutes les classes de Qt qui permet de voir la relation d'héritage entre chacune des classes. Ce diagramme (au format PDF) fait peur au premier abord, mais il est en fait vraiment intéressant. Vous voyez qui hérite de qui. Vous constatez par exemple comme je vous l'ai dit que la plupart des classes héritent directement ou indirectement de QObject.
  Par exemple, on voit que QPushButton hérite des propriétés de QAbstractButton, qui hérite de QWidget, qui hérite de QObject ! Ah les joies du C++
  Je vous aurais bien conseillé de l'imprimer et de l'afficher dans votre chambre, mais c'est un peu trop gros pour être imprimé sur une feuille A4. Quoi qu'il en soit, ça peut être intéressant pour se repérer parmi les classes de Qt.

Core Features

Key Technologies

Add-ons & Services

• du support
• des formations
• etc.

Tools

• Qt Designer : le logiciel qui permet de dessiner à la souris une interface graphique ;
• Qt Assistant : le logiciel qui contient la documentation dont j'ai parlé au début du chapitre ;
• Qt Linguist : le logiciel qui permet de traduire une application de Qt vers une autre langue ;
• qmake : l'utilitaire indispensable pour compiler une application Qt. Il propose beaucoup d'options et nous n'en avons vu qu'une petite partie pour le moment (la partie essentielle). Vous pourrez en apprendre plus sur la syntaxe des fichiers de projet .pro.
  Vous aurez peut-être besoin de lire cette section lorsque vous ferez des programmes un peu plus complexes ;
• All Tools : la liste de tous les outils proposés par Qt (y compris les précédents que je viens de citer).

Licenses & Credits

Introduction

1

#include <QLineEdit>

Public Types

Properties

Euh, ce ne sont pas des attributs ça par hasard ?

• propriete() : c'est la méthode accesseur qui vous permet de lire la propriété ;
• setPropriete() : c'est la méthode accesseur qui vous permet de modifier la propriété.

1
2

QLineEdit monChamp("Contenu du champ");
QString contenu = monChamp.text();

1
2

QLineEdit monChamp;
monChamp.setText("Entrez votre nom ici");

• QString text () const
• void setText ( const QString & )

Public Functions

• le (ou les) constructeur(s) de la classe. Très intéressant pour savoir comment créer un objet à partir de cette classe ;
• les accesseurs de la classe (comme text() et setText() qu'on vient de voir), basés sur les attributs ;
• et enfin d'autres méthodes publiques qui ne sont ni des constructeurs ni des accesseurs et qui effectuent diverses opérations sur l'objet. Par exemple : home(), qui ramène le curseur au début du champ de texte.

Lire et comprendre le prototype

• QLineEdit ( QWidget * parent = 0 )
• QLineEdit ( const QString & contents, QWidget * parent = 0 )

1
2
3
4

QLineEdit monChamp(); // Appel du premier constructeur
QLineEdit monChamp(fenetre); // Appel du premier constructeur
QLineEdit monChamp("Entrez un texte"); // Appel du second constructeur
QLineEdit monChamp("Entrez un texte", fenetre); // Appel du second constructeur

Quand la méthode attend un paramètre d'un type que vous ne connaissez pas...

• Les énumérations : Qt::Alignment en est une. Les énumérations sont très simples à utiliser, c'est une série de valeurs. Il suffit d'écrire la valeur que l'on veut, comme le donne la documentation de Qt::Alignment, par exemple Qt::AlignCenter. La méthode pourra donc être appelée comme ceci :
  
  Code : C++

  1	monChamp.setAlignment(Qt::AlignCenter);

  
  
  
• Les classes : parfois, la méthode attend un objet issu d'une classe précise pour travailler. Là c'est un peu plus compliqué : il va falloir créer un objet de cette classe et l'envoyer à la méthode.
  
  Prenons par exemple setValidator, qui attend un pointeur vers un QValidator. La méthode setValidator vous dit qu'elle permet de vérifier si l'utilisateur a rentré un texte valide, ce qui peut être utile si vous voulez vérifier que l'utilisateur a bien rentré un nombre entier et non pas "Bonjour ça va ?" quand vous lui demandez son âge...
  Si vous cliquez sur le lien QValidator, on vous emmène vers la page qui explique comment utiliser la classe QValidator. Lisez le texte d'introduction pour comprendre ce que cette classe est censée faire, puis regardez les constructeurs afin de savoir comment créer un objet de type QValidator.
  
  Parfois, comme là, c'est même un peu plus délicat. QValidator est une classe abstraite (c'est ce que vous dit l'intro de sa doc), ce qui signifie qu'on ne peut pas créer d'objet de type QValidator et qu'il faut utiliser une de ses classes filles
  Au tout début, la page de la doc de QValidator vous dit "Inherited by QDoubleValidator, QIntValidator, and QRegExpValidator". Cela signifie que ces classes héritent de QValidator et que vous pouvez les utiliser aussi. En effet, une classe fille est compatible avec la classe mère, comme nous l'avons déjà vu dans le chapitre sur l'héritage.
  
  Nous, nous voulons autoriser uniquement la personne à rentrer un nombre entier, nous allons donc utiliser QIntValidator. Il faut créer un objet de type QIntValidator. Regardez ses constructeurs et choisissez celui qui vous convient.
  
  Au final (ouf !), pour utiliser setValidator, on peut faire comme ceci :
  
  Code : C++

  1 2	QValidator *validator = new QIntValidator(0, 150, this); monChamp.setValidator(validator);

  
  
  ... pour s'assurer que la personne ne rentrera qu'un nombre compris entre 0 et 150 ans (ça laisse de la marge ).

Public Slots

1

monChamp.undo();

Signals

Protected Functions

Additional Inherited Members

1

QString maChaine = QString::number(12);