Home · Examples 


Carnet d'adresse 7 - Fonctionnalitées avancées

[Previous: Carnet d'Adresses 6 - Sauvegarde et chargement][Tutoriel "Carnet d'adresses"]

Ce chapitre couvre quelques fonctionnalités additionnelles qui feront de notre carnet d'adresses une application plus pratique pour une utilisation quotidienne.


Bien que notre application carnet d'adresses soit utile en tant que telle, il serait pratique de pouvoir échanger les contacts avec d'autres applications. Le format vCard est un un format de fichier populaire pour échanger ce type de données. Dans ce chapitre, nous étendrons notre carnet d'adresses pour permettre d'exporter des contacts dans des fichiers vCard .vcf.

Définir la classe AddressBook

Nous ajoutons un objet
QPushButton, exportButton, et un slot public correspondant, exportAsVCard(), à notre classe AddressBook dans le fichier addressbook.h.Error parsing snippet.... QPushButton *exportButton;

Implémenter la classe AddressBook

Dans le constructeur de AddressBook, nous connectons le signal clicked() de exportButton au slot exportAsVCard(). Nous ajoutons aussi ce bouton à buttonLayout1, le layout responsable du paneau de bouton sur la droite.

Dans la méthode exportAsVCard(), nous commençons par extraire le nom du contact dans \n name. Nous déclarons firstname, lastName et nameList. Ensuite, nous cherchons la position du premier espace blanc de name. Si il y a un espace, nous séparons le nom du contact en firstName et lastName. Finalement, nous remplaçons l'espace par un underscore ("_"). Si il n'y a pas d'espace, nous supposons que le contact ne comprend que le prénom.

The following code example is written in c++.

void AddressBook::exportAsVCard()
{
    QString name = nameLine->text();
    QString address = addressText->toPlainText();
    QString firstName;
    QString lastName;
    QStringList nameList;

    int index = name.indexOf(" ");

    if (index != -1) {
        nameList = name.split(QRegExp("\\s+"), QString::SkipEmptyParts);
        firstName = nameList.first();
        lastName = nameList.last();
    } else {
        firstName = name;
        lastName = "";
    }

    QString fileName = QFileDialog::getSaveFileName(this,
        tr("Export Contact"), "",
        tr("vCard Files (*.vcf);;All Files (*)"));
        
    if (fileName.isEmpty())
        return;

    QFile file(fileName);
Comme pour la méthode saveToFile(), nous ouvrons une boîte de dialogue pour donner la possibilité à l'utilisateur de choisir un emplacement pour le fichier. Avec le nom de fichier choisi, nous créons une instance de
QFile pour y écrire.

Nous essayons d'ouvrir le fichier en mode WriteOnly. Si cela échoue, nous affichons un QMessageBox pour informer l'utilisateur à propos de l'origine du problème et nous quittons la méthode. Sinon, nous passons le fichier comme paramètre pour créer un objet QTextStream, out. De la même façon que QDataStream, la classe QTextStream fournit les fonctionnalités pour lire et écrire des fichiers de texte. Grâce à celà, le fichier .vcf généré pourra être ouvert et édité à l'aide d'un simple éditeur de texte.

The following code example is written in c++.

    
    if (!file.open(QIODevice::WriteOnly)) {
        QMessageBox::information(this, tr("Unable to open file"),
            file.errorString());
        return;
    }

    QTextStream out(&file);
Nous écrivons ensuite un fichier vCard avec la balise BEGIN:VCARD, suivit par VERSION:2.1. Le nom d'un contact est écrit à l'aide de la balise N:. Pour la balise FN:, qui rempli le titre du contact, nous devons vérifier si le contact à définit un nom de famille ou pas. Si oui, nous utilions les détails de nameList pour remplir le champ, si non nous écrivons uniquement le contenu de firstName.

The following code example is written in c++.
    out << "BEGIN:VCARD" << "\n";
    out << "VERSION:2.1" << "\n";
    out << "N:" << lastName << ";" << firstName << "\n";
        
    if (!nameList.isEmpty())            
       out << "FN:" << nameList.join(" ") << "\n";
    else
       out << "FN:" << firstName << "\n";
Nous continuons par écrire l'adresse du contact. Les points-virgules dans l'adresse sont échapés à l'aide de "\", les retours de ligne sont remplacés par des point-virgules, et les vigules sont remplacés par des espaces. Finalement nous écrivons les balises ADR;HOME:; suivit par l'addresse et la balise END:VCARD.

The following code example is written in c++.
    address.replace(";", "\\;", Qt::CaseInsensitive);
    address.replace("\n", ";", Qt::CaseInsensitive);
    address.replace(",", " ", Qt::CaseInsensitive);

    out << "ADR;HOME:;" << address << "\n";
    out << "END:VCARD" << "\n";

    QMessageBox::information(this, tr("Export Successful"),
        tr("\"%1\" has been exported as a vCard.").arg(name));
}
À la fin de la méthode, un QMessageBox est affiché pour informer l'utilisateur que la vCard a été exporté avec succès.

vCard est une marque déposée de Internet Mail Consortium.


Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Jambi 4.5.2_01