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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
<?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 4 - éditer et supprimer des adresses</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 4 - éditer et supprimer des adresses</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>
<li class="level2"><a href="#mise-jour-de-l-interface-utilisateur">Mise à jour de l'Interface utilisateur</a></li>
</ul>
</div>
<h1 class="title">Carnet d'Adresses 4 - éditer et supprimer des adresses</h1>
<span class="subtitle"></span>
<!-- $$$tutorials/addressbook-fr/part4-description -->
<div class="descr"> <a name="details"></a>
<p>Files:</p>
<ul>
<li><a href="tutorials-addressbook-fr-part4-addressbook-cpp.html">tutorials/addressbook-fr/part4/addressbook.cpp</a></li>
<li><a href="tutorials-addressbook-fr-part4-addressbook-h.html">tutorials/addressbook-fr/part4/addressbook.h</a></li>
<li><a href="tutorials-addressbook-fr-part4-main-cpp.html">tutorials/addressbook-fr/part4/main.cpp</a></li>
<li><a href="tutorials-addressbook-fr-part4-part4-pro.html">tutorials/addressbook-fr/part4/part4.pro</a></li>
</ul>
<p>Dans ce chapitre, nous verrons comment modifier les données des contacts contenus dans l'application carnet d'adresses.</p>
<p class="centerAlign"><img src="images/addressbook-tutorial-screenshot.png" alt="" /></p><p>Nous avons maintenant un carnet d'adresses qui ne se contente pas de lister des contacts de façon ordonnée, mais permet également la navigation. Il serait pratique d'inclure des fonctions telles qu'éditer et supprimer, afin que les détails associés à un contact puissent être modifiés lorsque c'est nécessaire. Cependant, cela requiert une légère modification, sous la forme d'énumérations. Au chapitre précédent, nous avions deux modes: <tt>AddingMode</tt> et <tt>NavigationMode</tt>, mais ils n'étaient pas définis en tant qu'énumérations. Au lieu de ça, on activait et désactivait les boutons correspondants manuellement, au prix de multiples redondances dans le code.</p>
<p>Dans ce chapitre, on définit l'énumération <tt>Mode</tt> avec trois valeurs possibles.</p>
<ul>
<li><tt>NavigationMode</tt>,</li>
<li><tt>AddingMode</tt>, et</li>
<li><tt>EditingMode</tt>.</li>
</ul>
<a name="d-finition-de-la-classe-addressbook"></a>
<h2>Définition de la classe AddressBook</h2>
<p>Le fichier <tt>addressbook.h</tt> est mis a jour pour contenir l'énumération <tt>Mode</tt> :</p>
<pre class="cpp"> <span class="keyword">enum</span> Mode { NavigationMode<span class="operator">,</span> AddingMode<span class="operator">,</span> EditingMode };</pre>
<p>On ajoute également deux nouveaux slots, <tt>editContact()</tt> et <tt>removeContact()</tt>, à notre liste de slots publics.</p>
<pre class="cpp"> <span class="type">void</span> editContact();
<span class="type">void</span> removeContact();</pre>
<p>Afin de basculer d'un mode à l'autre, on introduit la méthode <tt>updateInterface()</tt> pour contrôller l'activation et la désactivation de tous les objets <a href="qpushbutton.html">QPushButton</a>. On ajoute également deux nouveaux boutons, <tt>editButton</tt> et <tt>removeButton</tt>, pour les fonctions d'édition et de suppression mentionnées plus haut.</p>
<pre class="cpp"> <span class="type">void</span> updateInterface(Mode mode);
...
<span class="type"><a href="qpushbutton.html">QPushButton</a></span> <span class="operator">*</span>editButton;
<span class="type"><a href="qpushbutton.html">QPushButton</a></span> <span class="operator">*</span>removeButton;
...
Mode currentMode;</pre>
<p>Enfin, on déclare <tt>currentMode</tt> pour garder une trace du mode actuellement utilisé.</p>
<a name="impl-mentation-de-la-classe-addressbook"></a>
<h2>Implémentation de la classe AddressBook</h2>
<p>Il nous faut maintenant implémenter les fonctionnalités de changement de mode de l'application carnet d'adresses. Les boutons <tt>editButton</tt> et <tt>removeButton</tt> sont instanciés et désactivés par défaut, puisque le carnet d'adresses démarre sans aucun contact en mémoire.</p>
<pre class="cpp"> editButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qpushbutton.html">QPushButton</a></span>(tr(<span class="string">"&Edit"</span>));
editButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
removeButton <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qpushbutton.html">QPushButton</a></span>(tr(<span class="string">"&Remove"</span>));
removeButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);</pre>
<p>Ces boutons sont ensuite connectés à leurs slots respectifs, <tt>editContact()</tt> et <tt>removeContact()</tt>, avant d'être ajoutés à <tt>buttonLayout1</tt>.</p>
<pre class="cpp"> connect(editButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(editContact()));
connect(removeButton<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(removeContact()));
...
buttonLayout1<span class="operator">-</span><span class="operator">></span>addWidget(editButton);
buttonLayout1<span class="operator">-</span><span class="operator">></span>addWidget(removeButton);</pre>
<p>La methode <tt>editContact()</tt> place les anciens détails du contact dans <tt>oldName</tt> et <tt>oldAddress</tt>, avant de basculer vers le mode <tt>EditingMode</tt>. Dans ce mode, les boutons <tt>submitButton</tt> et <tt>cancelButton</tt> sont tous deux activés, l'utilisateur peut par conséquent modifier les détails du contact et cliquer sur l'un de ces deux boutons par la suite.</p>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>editContact()
{
oldName <span class="operator">=</span> nameLine<span class="operator">-</span><span class="operator">></span>text();
oldAddress <span class="operator">=</span> addressText<span class="operator">-</span><span class="operator">></span>toPlainText();
updateInterface(EditingMode);
}</pre>
<p>La méthode <tt>submitContact()</tt> a été divisée en deux avec un bloc <tt>if-else</tt>. On teste <tt>currentMode</tt> pour voir si le mode courant est <tt>AddingMode</tt>. Si c'est le cas, on procède à l'ajout.</p>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>submitContact()
{
...
<span class="keyword">if</span> (currentMode <span class="operator">=</span><span class="operator">=</span> AddingMode) {
<span class="keyword">if</span> (<span class="operator">!</span>contacts<span class="operator">.</span>contains(name)) {
contacts<span class="operator">.</span>insert(name<span class="operator">,</span> address);
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Add Successful"</span>)<span class="operator">,</span>
tr(<span class="string">"\"%1\" has been added to your address book."</span>)<span class="operator">.</span>arg(name));
} <span class="keyword">else</span> {
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Add Unsuccessful"</span>)<span class="operator">,</span>
tr(<span class="string">"Sorry, \"%1\" is already in your address book."</span>)<span class="operator">.</span>arg(name));
}</pre>
<p>Sinon, on s'assure que <tt>currentMode</tt> est en <tt>EditingMode</tt>. Si c'est le cas, on compare <tt>oldName</tt> et <tt>name</tt>. Si le nom a changé, on supprime l'ancien contact de <tt>contacts</tt> et on insère le contact mis a jour.</p>
<pre class="cpp"> } <span class="keyword">else</span> <span class="keyword">if</span> (currentMode <span class="operator">=</span><span class="operator">=</span> EditingMode) {
<span class="keyword">if</span> (oldName <span class="operator">!</span><span class="operator">=</span> name) {
<span class="keyword">if</span> (<span class="operator">!</span>contacts<span class="operator">.</span>contains(name)) {
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Edit Successful"</span>)<span class="operator">,</span>
tr(<span class="string">"\"%1\" has been edited in your address book."</span>)<span class="operator">.</span>arg(oldName));
contacts<span class="operator">.</span>remove(oldName);
contacts<span class="operator">.</span>insert(name<span class="operator">,</span> address);
} <span class="keyword">else</span> {
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Edit Unsuccessful"</span>)<span class="operator">,</span>
tr(<span class="string">"Sorry, \"%1\" is already in your address book."</span>)<span class="operator">.</span>arg(name));
}
} <span class="keyword">else</span> <span class="keyword">if</span> (oldAddress <span class="operator">!</span><span class="operator">=</span> address) {
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Edit Successful"</span>)<span class="operator">,</span>
tr(<span class="string">"\"%1\" has been edited in your address book."</span>)<span class="operator">.</span>arg(name));
contacts<span class="operator">[</span>name<span class="operator">]</span> <span class="operator">=</span> address;
}
}
updateInterface(NavigationMode);
}</pre>
<p>Si seule l'adresse a changé (i.e. <tt>oldAddress</tt> n'est pas identique à <tt>address</tt>), on met à jour l'adresse du contact. Enfin on règle <tt>currentMode</tt> à <tt>NavigationMode</tt>. C'est une étape importante puisque c'est cela qui réactive tous les boutons désactivés.</p>
<p>Afin de retirer un contact du carnet d'adresses, on implémente la méthode <tt>removeContact()</tt>. Cette méthode vérifie que le contact est présent dans <tt>contacts</tt>.</p>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>removeContact()
{
<span class="type"><a href="qstring.html">QString</a></span> name <span class="operator">=</span> nameLine<span class="operator">-</span><span class="operator">></span>text();
<span class="type"><a href="qstring.html">QString</a></span> address <span class="operator">=</span> addressText<span class="operator">-</span><span class="operator">></span>toPlainText();
<span class="keyword">if</span> (contacts<span class="operator">.</span>contains(name)) {
<span class="type">int</span> button <span class="operator">=</span> <span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>question(<span class="keyword">this</span><span class="operator">,</span>
tr(<span class="string">"Confirm Remove"</span>)<span class="operator">,</span>
tr(<span class="string">"Are you sure you want to remove \"%1\"?"</span>)<span class="operator">.</span>arg(name)<span class="operator">,</span>
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>Yes <span class="operator">|</span> <span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>No);
<span class="keyword">if</span> (button <span class="operator">=</span><span class="operator">=</span> <span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>Yes) {
previous();
contacts<span class="operator">.</span>remove(name);
<span class="type"><a href="qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Remove Successful"</span>)<span class="operator">,</span>
tr(<span class="string">"\"%1\" has been removed from your address book."</span>)<span class="operator">.</span>arg(name));
}
}
updateInterface(NavigationMode);
}</pre>
<p>Si c'est le cas, on affiche une boîte de dialogue <a href="qmessagebox.html">QMessageBox</a>, demandant confirmation de la suppression à l'utilisateur. Une fois la confirmation effectuée, on appelle <tt>previous()</tt>, afin de s'assurer que l'interface utilisateur affiche une autre entrée, et on supprime le contact en utilisant le méthode <a href="qmap.html#remove">remove()</a> de <a href="qmap.html">QMap</a>. Dans un souci pratique, on informe l'utilisateur de la suppression par le biais d'une autre <a href="qmessagebox.html">QMessageBox</a>. Les deux boîtes de dialogue utilisées dans cette méthode sont représentées ci-dessous.</p>
<p class="centerAlign"><img src="images/addressbook-tutorial-part4-remove.png" alt="" /></p><a name="mise-jour-de-l-interface-utilisateur"></a>
<h3>Mise à jour de l'Interface utilisateur</h3>
<p>On a évoqué plus haut la méthode <tt>updateInterface()</tt> comme moyen d'activer et de désactiver les différents boutons de l'interface en fonction du mode. Cette méthode met à jour le mode courant selon l'argument <tt>mode</tt> qui lui est passé, en l'assignant à <tt>currentMode</tt>, avant de tester sa valeur.</p>
<p>Chacun des boutons est ensuite activé ou désactivé, en fonction du mode. Le code source pour les cas <tt>AddingMode</tt> et <tt>EditingMode</tt> est visible ci-dessous:</p>
<pre class="cpp"> <span class="type">void</span> AddressBook<span class="operator">::</span>updateInterface(Mode mode)
{
currentMode <span class="operator">=</span> mode;
<span class="keyword">switch</span> (currentMode) {
<span class="keyword">case</span> AddingMode:
<span class="keyword">case</span> EditingMode:
nameLine<span class="operator">-</span><span class="operator">></span>setReadOnly(<span class="keyword">false</span>);
nameLine<span class="operator">-</span><span class="operator">></span>setFocus(<span class="type"><a href="qt.html">Qt</a></span><span class="operator">::</span>OtherFocusReason);
addressText<span class="operator">-</span><span class="operator">></span>setReadOnly(<span class="keyword">false</span>);
addButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
editButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
removeButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
nextButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
previousButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">false</span>);
submitButton<span class="operator">-</span><span class="operator">></span>show();
cancelButton<span class="operator">-</span><span class="operator">></span>show();
<span class="keyword">break</span>;</pre>
<p>Dans le cas de <tt>NavigationMode</tt>, en revanche, des tests conditionnels sont passés en paramètre de <a href="qwidget.html#enabled-prop">QPushButton::setEnabled</a>(). Ceci permet de s'assurer que les boutons <tt>editButton</tt> et <tt>removeButton</tt> ne sont activés que s'il existe au moins un contact dans le carnet d'adresses; <tt>nextButton</tt> et <tt>previousButton</tt> ne sont activés que lorsqu'il existe plus d'un contact dans le carnet d'adresses.</p>
<pre class="cpp"> <span class="keyword">case</span> NavigationMode:
<span class="keyword">if</span> (contacts<span class="operator">.</span>isEmpty()) {
nameLine<span class="operator">-</span><span class="operator">></span>clear();
addressText<span class="operator">-</span><span class="operator">></span>clear();
}
nameLine<span class="operator">-</span><span class="operator">></span>setReadOnly(<span class="keyword">true</span>);
addressText<span class="operator">-</span><span class="operator">></span>setReadOnly(<span class="keyword">true</span>);
addButton<span class="operator">-</span><span class="operator">></span>setEnabled(<span class="keyword">true</span>);
<span class="type">int</span> number <span class="operator">=</span> contacts<span class="operator">.</span>size();
editButton<span class="operator">-</span><span class="operator">></span>setEnabled(number <span class="operator">></span><span class="operator">=</span> <span class="number">1</span>);
removeButton<span class="operator">-</span><span class="operator">></span>setEnabled(number <span class="operator">></span><span class="operator">=</span> <span class="number">1</span>);
nextButton<span class="operator">-</span><span class="operator">></span>setEnabled(number <span class="operator">></span> <span class="number">1</span>);
previousButton<span class="operator">-</span><span class="operator">></span>setEnabled(number <span class="operator">></span><span class="number">1</span> );
submitButton<span class="operator">-</span><span class="operator">></span>hide();
cancelButton<span class="operator">-</span><span class="operator">></span>hide();
<span class="keyword">break</span>;
}
}</pre>
<p>En effectuant les opérations de réglage du mode et de mise à jour de l'interface utilisateur au sein de la même méthode, on est à l'abri de l'éventualité où l'interface utilisateur se "désynchronise" de l'état interne de l'application.</p>
</div>
<!-- @@@tutorials/addressbook-fr/part4 -->
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</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>
|
