File: tutorials-addressbook-fr-part3.html

package info (click to toggle)
qt4-x11 4%3A4.8.2%2Bdfsg-11
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 701,696 kB
  • sloc: cpp: 2,686,179; ansic: 375,485; python: 25,859; sh: 19,349; xml: 17,091; perl: 14,765; yacc: 5,383; asm: 5,038; makefile: 1,259; lex: 555; ruby: 526; objc: 347; cs: 112; pascal: 112; php: 54; sed: 34
file content (152 lines) | stat: -rw-r--r-- 13,858 bytes parent folder | download 
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- addressbook-fr.qdoc -->
  <title>Qt 4.8: Carnet d'adresses 3 - Navigation entre les éléments</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
<li><a href="all-examples.html">Examples</a></li>
<li>Carnet d'adresses 3 - Navigation entre les éléments</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#d-finition-de-la-classe-addressbook">Définition de la classe AddressBook</a></li>
<li class="level1"><a href="#impl-mentation-de-la-classe-addressbook">Implémentation de la classe AddressBook</a></li>
</ul>
</div>
<h1 class="title">Carnet d'adresses 3 - Navigation entre les éléments</h1>
<span class="subtitle"></span>
<!-- $$$tutorials/addressbook-fr/part3-description -->
<div class="descr"> <a name="details"></a>
<p>Files:</p>
<ul>
<li><a href="tutorials-addressbook-fr-part3-addressbook-cpp.html">tutorials/addressbook-fr/part3/addressbook.cpp</a></li>
<li><a href="tutorials-addressbook-fr-part3-addressbook-h.html">tutorials/addressbook-fr/part3/addressbook.h</a></li>
<li><a href="tutorials-addressbook-fr-part3-main-cpp.html">tutorials/addressbook-fr/part3/main.cpp</a></li>
<li><a href="tutorials-addressbook-fr-part3-part3-pro.html">tutorials/addressbook-fr/part3/part3.pro</a></li>
</ul>
<p>L'application &quot;Carnet d'adresses&quot; est maintenant à moitié terminée. Il nous faut maintenant ajouter quelques fonctions pour naviguer entre les contacts. Avant de commencer, il faut se décider sur le type de structure de données le plus approprié pour stocker les contacts.</p>
<p>Dans le chapitre 2, nous avons utilisé un <a href="qmap.html">QMap</a> utilisant des paires clé-valeur, avec le nom du contact comme <i>clé</i>, et l'adresse du contact comme <i>valeur</i>. Cela fonctionnait bien jusqu'ici, mais pour ajouter la navigation entre les entrées, quelques améliorations sont nécessaires.</p>
<p>Nous améliorerons le <a href="qmap.html">QMap</a> en le faisant ressembler à une structure de données similaire à une liste liée, où tous les éléments sont connectés, y compris le premier et le dernier élément. La figure ci-dessous illustre cette structure de donnée.</p>
<p class="centerAlign"><img src="images/addressbook-tutorial-part3-linkedlist.png" alt="" /></p><a name="d-finition-de-la-classe-addressbook"></a>
<h2>Définition de la classe AddressBook</h2>
<p>Pour ajouter les fonctions de navigation au carnet d'adresses, nous avons besoin de deux slots supplémentaires dans notre classe <tt>AddressBook</tt>: <tt>next()</tt> et <tt>previous()</tt>. Ceux-ci sont ajoutés au fichier addressbook.h:</p>
<pre class="cpp">     <span class="type">void</span> next();
     <span class="type">void</span> previous();</pre>
<p>Nous avons aussi besoin de deux nouveaux objets <a href="qpushbutton.html">QPushButton</a>, nous ajoutons donc les variables privées <tt>nextButton</tt> et <tt>previousButton</tt>.</p>
<pre class="cpp">     <span class="type"><a href="qpushbutton.html">QPushButton</a></span> <span class="operator">*</span>nextButton;
     <span class="type"><a href="qpushbutton.html">QPushButton</a></span> <span class="operator">*</span>previousButton;</pre>
<a name="impl-mentation-de-la-classe-addressbook"></a>
<h2>Implémentation de la classe AddressBook</h2>
<p>A l'intérieur du constructeur de <tt>AddressBook</tt>, dans <tt>addressbook.cpp</tt>, nous instancions <tt>nextButton</tt> et <tt>previousButton</tt> et nous les désactivons par défaut. Nous faisons ceci car la navigation ne doit être activée que lorsqu'il y a plus d'un contact dans le carnet d'adresses.</p>
<pre class="cpp">     nextButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;&amp;Next&quot;</span>));
     nextButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">false</span>);
     previousButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;&amp;Previous&quot;</span>));
     previousButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">false</span>);</pre>
<p>Nous connectons alors ces boutons à leur slots respectifs:</p>
<pre class="cpp">     connect(nextButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(next()));
     connect(previousButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(previous()));</pre>
<p>L'image ci-dessous montre l'interface utilisateur que nous allons créer. Remarquez que cela ressemble de plus en plus à l'interface du programme complet.</p>
<p class="centerAlign"><img src="images/addressbook-tutorial-part3-screenshot.png" alt="" /></p><p>Nous suivons les conventions pour les fonctions <tt>next()</tt> et <tt>previous()</tt> en plaçant <tt>nextButton</tt> à droite et <tt>previousButton</tt> à gauche. Pour faire cette mise en page intuitive, nous utilisons un <a href="qhboxlayout.html">QHBoxLayout</a> pour placer les widgets côte à côte:</p>
<pre class="cpp">     <span class="type"><a href="qhboxlayout.html">QHBoxLayout</a></span> <span class="operator">*</span>buttonLayout2 <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qhboxlayout.html">QHBoxLayout</a></span>;
     buttonLayout2<span class="operator">-</span><span class="operator">&gt;</span>addWidget(previousButton);
     buttonLayout2<span class="operator">-</span><span class="operator">&gt;</span>addWidget(nextButton);</pre>
<p>L'objet <a href="qhboxlayout.html">QHBoxLayout</a>, <tt>buttonLayout2</tt>, est ensuite ajouté à <tt>mainLayout</tt>.</p>
<pre class="cpp">     mainLayout<span class="operator">-</span><span class="operator">&gt;</span>addLayout(buttonLayout2<span class="operator">,</span> <span class="number">2</span><span class="operator">,</span> <span class="number">1</span>);</pre>
<p>La figure ci-dessous montre les systèmes de coordonnées pour les widgets du <tt>mainLayout</tt>.</p>
<p class="centerAlign"><img src="images/addressbook-tutorial-part3-labeled-layout.png" alt="" /></p><p>Dans notre méthode <tt>addContact()</tt>, nous avons desactivé ces boutons pour être sûr que l'utilisateur n'utilise pas la navigation lors de l'ajout d'un contact.</p>
<pre class="cpp">     nextButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">false</span>);
     previousButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">false</span>);</pre>
<p>Dans notre méthode <tt>submitContact()</tt>, nous activons les boutons de navigation, <tt>nextButton</tt> et <tt>previousButton</tt>, en fonction de la taille de <tt>contacts</tt>. Commen mentionné plus tôt, la navigation n'est activée que si il y a plus d'un contact dans le carnet d'adresses. Les lignes suivantes montrent comment faire cela:</p>
<pre class="cpp">     <span class="type">int</span> number <span class="operator">=</span> contacts<span class="operator">.</span>size();
     nextButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(number <span class="operator">&gt;</span> <span class="number">1</span>);
     previousButton<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(number <span class="operator">&gt;</span> <span class="number">1</span>);</pre>
<p>Nous incluons aussi ces lignes de code dans le bouton <tt>cancel()</tt>.</p>
<p>Souvenez vous que nous voulons émuler une liste-liée ciruculaire à l'aide de l'objet <a href="qmap.html">QMap</a>, <tt>contacts</tt>. Pour faire cela, nous obtenons un itérateur sur <tt>contact</tt> dans la méthode <tt>next()</tt>, et ensuite:</p>
<ul>
<li>Si l'itérateur n'est pas à la fin de <tt>contacts</tt>, nous l'incrémentons</li>
<li>Si l'itérateur est à la fin de <tt>contacts</tt>, nous changeons sa position jusqu'au début de <tt>contacts</tt>. Cela donne l'illusion que notre <a href="qmap.html">QMap</a> fonctionne comme une liste circulaire.</li>
</ul>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>next()
 {
     <span class="type"><a href="qstring.html">QString</a></span> name <span class="operator">=</span> nameLine<span class="operator">-</span><span class="operator">&gt;</span>text();
     <span class="type"><a href="qmap.html">QMap</a></span><span class="operator">&lt;</span><span class="type"><a href="qstring.html">QString</a></span><span class="operator">,</span> <span class="type"><a href="qstring.html">QString</a></span><span class="operator">&gt;</span><span class="operator">::</span>iterator i <span class="operator">=</span> contacts<span class="operator">.</span>find(name);

     <span class="keyword">if</span> (i <span class="operator">!</span><span class="operator">=</span> contacts<span class="operator">.</span>end())
         i<span class="operator">+</span><span class="operator">+</span>;

     <span class="keyword">if</span> (i <span class="operator">=</span><span class="operator">=</span> contacts<span class="operator">.</span>end())
         i <span class="operator">=</span> contacts<span class="operator">.</span>begin();

     nameLine<span class="operator">-</span><span class="operator">&gt;</span>setText(i<span class="operator">.</span>key());
     addressText<span class="operator">-</span><span class="operator">&gt;</span>setText(i<span class="operator">.</span>value());
 }</pre>
<p>Une fois que nous avons itéré jusqu'à l'objet recherché dans <tt>contacts</tt>, nous affichons son contenu sur <tt>nameLine</tt> et <tt>addressText</tt>.</p>
<p>De la même façon, pour la méthode <tt>previous()</tt>, nous obtenons un itérateur sur <tt>contacts</tt> et ensuite:</p>
<ul>
<li>Si l'itérateur est à la fin de <tt>contacts</tt>, on réinitialise l'affichage et on retourne.</li>
<li>Si l'itérateur est au début de <tt>contacts</tt>, on change sa position jusqu'à la fin</li>
<li>Ensuite, on décrémente l'itérateur</li>
</ul>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>previous()
 {
     <span class="type"><a href="qstring.html">QString</a></span> name <span class="operator">=</span> nameLine<span class="operator">-</span><span class="operator">&gt;</span>text();
     <span class="type"><a href="qmap.html">QMap</a></span><span class="operator">&lt;</span><span class="type"><a href="qstring.html">QString</a></span><span class="operator">,</span> <span class="type"><a href="qstring.html">QString</a></span><span class="operator">&gt;</span><span class="operator">::</span>iterator i <span class="operator">=</span> contacts<span class="operator">.</span>find(name);

     <span class="keyword">if</span> (i <span class="operator">=</span><span class="operator">=</span> contacts<span class="operator">.</span>end()){
         nameLine<span class="operator">-</span><span class="operator">&gt;</span>clear();
         addressText<span class="operator">-</span><span class="operator">&gt;</span>clear();
         <span class="keyword">return</span>;
     }

     <span class="keyword">if</span> (i <span class="operator">=</span><span class="operator">=</span> contacts<span class="operator">.</span>begin())
         i <span class="operator">=</span> contacts<span class="operator">.</span>end();

     i<span class="operator">-</span><span class="operator">-</span>;
     nameLine<span class="operator">-</span><span class="operator">&gt;</span>setText(i<span class="operator">.</span>key());
     addressText<span class="operator">-</span><span class="operator">&gt;</span>setText(i<span class="operator">.</span>value());
 }</pre>
<p>à nouveau, nous affichons le contenu de l'objet courant dans <tt>contacts</tt>.</p>
</div>
<!-- @@@tutorials/addressbook-fr/part3 -->
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
    <p>
      <acronym title="Copyright">&copy;</acronym> 2012 Nokia Corporation and/or its
      subsidiaries. Documentation contributions included herein are the copyrights of
      their respective owners.</p>
    <br />
    <p>
      The documentation provided herein is licensed under the terms of the
      <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
      License version 1.3</a> as published by the Free Software Foundation.</p>
    <p>
      Documentation sources may be obtained from <a href="http://www.qt-project.org">
      www.qt-project.org</a>.</p>
    <br />
    <p>
      Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
      in Finland and/or other countries worldwide. All other trademarks are property
      of their respective owners. <a title="Privacy Policy"
      href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
</body>
</html>