Development/Tutorials/Akonadi/Application (fr) - Revision history

AnneW at 16:07, 19 July 2012

2012-07-19T16:07:30Z

Neverendingo: Text replace - "" to ""

2011-06-29T20:50:34Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:44:07Z
Text replace - "<code>" to "<syntaxhighlight lang="text">"

				
				
				
				
			
			← Older revision
			Revision as of 20:44, 29 June 2011
			
Line 38:
Line 38:
    
  Un coup d’œil dans le répertoire racine du projet généré montre les fichiers suivantes:   Un coup d’œil dans le répertoire racine du projet généré montre les fichiers suivantes:
− <code> + <syntaxhighlight lang="text">
  CMakeLists.txt   CMakeLists.txt
  detacher/   detacher/
Line 47:
Line 47:
  </code>   </code>
  et les fichiers suivants dans le sous répertoire '''src''':   et les fichiers suivants dans le sous répertoire '''src''':
− <code> + <syntaxhighlight lang="text">
  CMakeLists.txt   CMakeLists.txt
  detacher.cpp   detacher.cpp
Line 68:
Line 68:
    
  Depuis le répertoire racine du projet généré:   Depuis le répertoire racine du projet généré:
− <code> + <syntaxhighlight lang="text">
  mkdir build   mkdir build
  cd build   cd build
Line 78:
Line 78:
    
  Depuis le répertoire racine du projet généré:   Depuis le répertoire racine du projet généré:
− <code> + <syntaxhighlight lang="text">
  mkdir build   mkdir build
  cd build   cd build
Line 119:
Line 119:
    
  In the file from the top level directory add the following line   In the file from the top level directory add the following line
− <code> + <syntaxhighlight lang="text">
  find_package (KdepimLibs REQUIRED)   find_package (KdepimLibs REQUIRED)
  </code>   </code>
Line 125:
Line 125:
  and change   and change
    
− <code> + <syntaxhighlight lang="text">
  include_directories( ${KDE4_INCLUDES} ${QT_INCLUDES} )   include_directories( ${KDE4_INCLUDES} ${QT_INCLUDES} )
  </code>   </code>
Line 131:
Line 131:
  into   into
    
− <code> + <syntaxhighlight lang="text">
  include_directories( ${KDE4_INCLUDES} ${KDEPIMLIBS_INCLUDE_DIRS} ${QT_INCLUDES} )   include_directories( ${KDE4_INCLUDES} ${KDEPIMLIBS_INCLUDE_DIRS} ${QT_INCLUDES} )
  </code>   </code>
    
  In the file from the source directory the line   In the file from the source directory the line
− <code> + <syntaxhighlight lang="text">
  target_link_libraries(detacher ${KDE4_KDEUI_LIBS})   target_link_libraries(detacher ${KDE4_KDEUI_LIBS})
  </code>   </code>
Line 142:
Line 142:
  has to be changed to   has to be changed to
    
− <code> + <syntaxhighlight lang="text">
  target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS})   target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS})
  </code>   </code>
Line 221:
Line 221:
    
  To properly link this additional library change the source directory's '''CMakeLists.txt''' to this   To properly link this additional library change the source directory's '''CMakeLists.txt''' to this
− <code> + <syntaxhighlight lang="text">
  target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS} ${KDEPIMLIBS_AKONADI_KMIME_LIBS})   target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS} ${KDEPIMLIBS_AKONADI_KMIME_LIBS})
  </code>   </code>



Neverendingo: Text replace - "" to ""

2011-06-29T20:28:07Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:28, 29 June 2011
			
Line 154:
Line 154:
  A slot so we can delay its executing using a single shot timer, a technique called "Delayed Initialization", i.e. letting the application create and show its GUI as fast as possible and do any probably time consuming initialization after that.   A slot so we can delay its executing using a single shot timer, a technique called "Delayed Initialization", i.e. letting the application create and show its GUI as fast as possible and do any probably time consuming initialization after that.
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  private slots:   private slots:
       void fileNew();        void fileNew();
Line 162:
Line 162:
    
  In '''detacher.cpp''' we need two new include directives:   In '''detacher.cpp''' we need two new include directives:
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <QtCore/QTimer>   #include <QtCore/QTimer>
    
Line 169:
Line 169:
    
  and the slot's implementation   and the slot's implementation
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void Detacher::delayedInit()   void Detacher::delayedInit()
  {   {
Line 183:
Line 183:
  Since we want the slot to be executed delayed, add the following line at the end of the class' constructor   Since we want the slot to be executed delayed, add the following line at the end of the class' constructor
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  QTimer::singleShot( 0, this, SLOT( delayedInit() ) );   QTimer::singleShot( 0, this, SLOT( delayedInit() ) );
  </code>   </code>
Line 189:
Line 189:
  Lets add a new public method to the view class. In '''detacherview.h''' add   Lets add a new public method to the view class. In '''detacherview.h''' add
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void createModels();   void createModels();
  </code>   </code>
    
  and for now with an empty body in '''detacherview.cpp''' (we will get to the implementation shortly)   and for now with an empty body in '''detacherview.cpp''' (we will get to the implementation shortly)
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void DetacherView::createModels()   void DetacherView::createModels()
  {   {
Line 202:
Line 202:
  and call it from '''Detacher::delayedInit()''' after the Akonadi start succeeded   and call it from '''Detacher::delayedInit()''' after the Akonadi start succeeded
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void Detacher::delayedInit()   void Detacher::delayedInit()
  {   {
Line 227:
Line 227:
  In '''detacherview.cpp'' add the following include directives   In '''detacherview.cpp'' add the following include directives
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <akonadi/collectionfilterproxymodel.h>   #include <akonadi/collectionfilterproxymodel.h>
  #include <akonadi/collectionmodel.h>   #include <akonadi/collectionmodel.h>
Line 235:
Line 235:
  With that we can now properly implement the '''createModels()''' method:   With that we can now properly implement the '''createModels()''' method:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void DetacherView::createModels()   void DetacherView::createModels()
  {   {
Line 280:
Line 280:
  Using this is quite simple. First we add a new include and a class forward declaration for '''detacherview.h'''   Using this is quite simple. First we add a new include and a class forward declaration for '''detacherview.h'''
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <akonadi/item.h>   #include <akonadi/item.h>
  class KJob;   class KJob;
Line 286:
Line 286:
    
  In the private member section add an [http://api.kde.org/4.x-api/kdepimlibs-apidocs/akonadi/html/classAkonadi_1_1Item.html Item] member:   In the private member section add an [http://api.kde.org/4.x-api/kdepimlibs-apidocs/akonadi/html/classAkonadi_1_1Item.html Item] member:
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  private:   private:
       Ui::detacherview_base ui_detacherview_base;        Ui::detacherview_base ui_detacherview_base;
Line 295:
Line 295:
  and two new slots in the private slots section:   and two new slots in the private slots section:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  private slots:   private slots:
       void switchColors();        void switchColors();
Line 305:
Line 305:
    
  In the source file '''detacherview.cpp''' two new includes are required   In the source file '''detacherview.cpp''' two new includes are required
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <akonadi/itemfetchjob.h>   #include <akonadi/itemfetchjob.h>
  #include <akonadi/itemfetchscope.h>   #include <akonadi/itemfetchscope.h>
Line 311:
Line 311:
    
  for the implementation of the two new slots   for the implementation of the two new slots
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void DetacherView::itemChanged( const Akonadi::Item &item )   void DetacherView::itemChanged( const Akonadi::Item &item )
  {   {
Line 350:
Line 350:
  To trigger the item fetching we connect the first new slot to a signal of the MessageView. In '''DetacherView::createModels()''' add another '''connect''' statement:   To trigger the item fetching we connect the first new slot to a signal of the MessageView. In '''DetacherView::createModels()''' add another '''connect''' statement:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  connect( ui_detacherview_base.messageView, SIGNAL( currentChanged( Akonadi::Item ) ),   connect( ui_detacherview_base.messageView, SIGNAL( currentChanged( Akonadi::Item ) ),
            SLOT( itemChanged( Akonadi::Item ) ) );             SLOT( itemChanged( Akonadi::Item ) ) );
Line 363:
Line 363:
  For the application this means two more includes and a typedef:   For the application this means two more includes and a typedef:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <kmime/kmime_message.h>   #include <kmime/kmime_message.h>
  #include <boost/shared_ptr.hpp>   #include <boost/shared_ptr.hpp>
Line 373:
Line 373:
  Equipped with this new tools we can extend '''DetacherView::itemFetchDone()''' by adding the following code at its end:   Equipped with this new tools we can extend '''DetacherView::itemFetchDone()''' by adding the following code at its end:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  if ( !mItem.hasPayload<MessagePtr>() ) {   if ( !mItem.hasPayload<MessagePtr>() ) {
       kWarning() << "Item does not have message payload";        kWarning() << "Item does not have message payload";
Line 403:
Line 403:
  First we need a new slot in the private slots section of '''detacherview.h'''   First we need a new slot in the private slots section of '''detacherview.h'''
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void detachAttachment();   void detachAttachment();
  </code>   </code>
    
  To implement the first sub task, saving the selected attachment into a file, the following new includes are needed in '''detacherview.cpp'''   To implement the first sub task, saving the selected attachment into a file, the following new includes are needed in '''detacherview.cpp'''
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <kaction.h>   #include <kaction.h>
  #include <kfiledialog.h>   #include <kfiledialog.h>
Line 415:
Line 415:
    
  In the class' constructor create and connect an action and make it available as the attachment list widget's context menu:   In the class' constructor create and connect an action and make it available as the attachment list widget's context menu:
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  KAction *detachAction = KStandardAction::cut( this, SLOT( detachAttachment() ), this );   KAction *detachAction = KStandardAction::cut( this, SLOT( detachAttachment() ), this );
  detachAction->setText( i18nc( "@action:button remove an attachment from an email",   detachAction->setText( i18nc( "@action:button remove an attachment from an email",
Line 431:
Line 431:
    
  This can be implemented like this   This can be implemented like this
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  void DetacherView::detachAttachment()   void DetacherView::detachAttachment()
  {   {
Line 503:
Line 503:
    
  For the last step another job class is needed: [http://api.kde.org/4.x-api/kdepimlibs-apidocs/akonadi/html/classAkonadi_1_1ItemModifyJob.html ItemModifyJob]   For the last step another job class is needed: [http://api.kde.org/4.x-api/kdepimlibs-apidocs/akonadi/html/classAkonadi_1_1ItemModifyJob.html ItemModifyJob]
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include <akonadi/itemmodifyjob.h>   #include <akonadi/itemmodifyjob.h>
  </code>   </code>
Line 509:
Line 509:
  and can be implemented by appending the following code to '''DetacherView::detachAttachment()'''   and can be implemented by appending the following code to '''DetacherView::detachAttachment()'''
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  // remove attachment from message   // remove attachment from message
  message->removeContent( selectedAttachment, true );   message->removeContent( selectedAttachment, true );





Telliam: /* Adjusting the main Qt Designer file */
2010-07-29T12:06:19Z
‎Adjusting the main Qt Designer file

				
				
				
				
			
			← Older revision
			Revision as of 12:06, 29 July 2010
			
Line 85:
Line 85:
  Et ouvrir le projet généré avec KDevelop and lancer la génération depuis cet outil.   Et ouvrir le projet généré avec KDevelop and lancer la génération depuis cet outil.
    
− === Adjusting the main Qt Designer file === + === Ajuster le fichier principal de Qt Designer ===
    
− Open the file '''detacherview_base.ui''' in Qt Designer and remove the example label. + Ouvrir le fichier '''detacherview_base.ui''' dans Qt Designer et enlever le label d'exemple.
  Remove the widget's main layout by clicking on the now empty widget and use the '''Break Layout''' menu entry in the '''Form''' menu.   Remove the widget's main layout by clicking on the now empty widget and use the '''Break Layout''' menu entry in the '''Form''' menu.
    





Telliam: /* Preparation */
2010-07-29T11:54:51Z
‎Preparation

				
				
				
				
			
			← Older revision
			Revision as of 11:54, 29 July 2010
			
Line 37:
Line 37:
  [[Image:TutorialAkonadiDetacherTemplate.png]]   [[Image:TutorialAkonadiDetacherTemplate.png]]
    
− Un coup d’œil dans le répertoire racine du projet générés montre les fichiers suivantes: + Un coup d’œil dans le répertoire racine du projet généré montre les fichiers suivantes:
  <code>   <code>
  CMakeLists.txt   CMakeLists.txt





Telliam: /* Générer des Makefiles */
2010-07-29T11:25:49Z
‎Générer des Makefiles

				
				
				
				
			
			← Older revision
			Revision as of 11:25, 29 July 2010
			
Line 73:
Line 73:
  cmake -DCMAKE_BUILD_TYPE=debugfull ..   cmake -DCMAKE_BUILD_TYPE=debugfull ..
  </code>   </code>
− et lancer la génération en utilisant make comme à l'habitude. + Et lancer la génération en utilisant make comme à l'habitude.
    
  === Générer un fichier projet pour KDevelop ===   === Générer un fichier projet pour KDevelop ===





Telliam: /* Preparation */
2010-07-29T11:03:42Z
‎Preparation

				
				
				
				
			
			← Older revision
			Revision as of 11:03, 29 July 2010
			
Line 37:
Line 37:
  [[Image:TutorialAkonadiDetacherTemplate.png]]   [[Image:TutorialAkonadiDetacherTemplate.png]]
    
− A look at the generated project top level directory shows us the following files: + Un coup d’œil dans le répertoire racine du projet générés montre les fichiers suivantes:
  <code>   <code>
  CMakeLists.txt   CMakeLists.txt
Line 46:
Line 46:
  src/   src/
  </code>   </code>
− and the following files in sub directory '''src''': + et les fichiers suivants dans le sous répertoire '''src''':
  <code>   <code>
  CMakeLists.txt   CMakeLists.txt
  detacher.cpp   detacher.cpp
− detacher.desktop + detacher.desktop  
  detacher.h   detacher.h
  detacher.kcfg   detacher.kcfg
Line 63:
Line 63:
  </code>   </code>
    
− At this stage it is already possible to compile the application, so we can already check if our development environment is setup correctly by creating the build directory and having CMake either generate Makefiles or a KDevelop project file. + A cette étape il est déjà possible de compiler cette application, ainsi  nous pouvons déjà vérifier que l'environnement de développement est correctement configuré en créant le répertoire build et grâce à CMake qui permet de générer des Makefiles ou des fichiers projet pour KDevelop.
    
− === Generating Makefiles === + === Générer des Makefiles ===  
    
− From within the generated top level directory: + Depuis le répertoire racine du projet généré:
  <code>   <code>
  mkdir build   mkdir build
Line 73:
Line 73:
  cmake -DCMAKE_BUILD_TYPE=debugfull ..   cmake -DCMAKE_BUILD_TYPE=debugfull ..
  </code>   </code>
− and run the build using make as usual. + et lancer la génération en utilisant make comme à l'habitude.
    
− === Generating a KDevelop project file === + === Générer un fichier projet pour KDevelop ===
    
− From within the generated top level directory: + Depuis le répertoire racine du projet généré:
  <code>   <code>
  mkdir build   mkdir build
Line 83:
Line 83:
  cmake -DCMAKE_BUILD_TYPE=debugfull -G KDevelop3 ..   cmake -DCMAKE_BUILD_TYPE=debugfull -G KDevelop3 ..
  </code>   </code>
− and open the generated project with KDevelop and run the build process from there. + Et ouvrir le projet généré avec KDevelop and lancer la génération depuis cet outil.
    
  === Adjusting the main Qt Designer file ===   === Adjusting the main Qt Designer file ===



Telliam at 10:47, 29 July 2010
2010-07-29T10:47:22Z


				
				
				
				
			
			← Older revision
			Revision as of 10:47, 29 July 2010
			
Line 14:
Line 14:
  }}   }}
    
− Ce tutoriel vous guidera à travers les différentes étapes pour la création d'une application Akonadi, une interface utilisateur qui affiche et manipule les données PIM fournies par Akonadi. + Ce tutoriel vous guidera à travers les différentes étapes pour la création d'une application Akonadi, une interface utilisateur qui affichera et manipulera les données PIM fournies par Akonadi.
    
  Si vous recherchez un tutorial sur la façon de fournir des données pour Akonadi: voir     Si vous recherchez un tutorial sur la façon de fournir des données pour Akonadi: voir  
Line 27:
Line 27:
  Le but de ce tutoriel est de créer une application simple permettant à un utilisateur de récupérer les pièces jointes de ses courriels, i.e les sauvegarder sur disque et de les retirer des messages.   Le but de ce tutoriel est de créer une application simple permettant à un utilisateur de récupérer les pièces jointes de ses courriels, i.e les sauvegarder sur disque et de les retirer des messages.
    
− Pour rester concentré sur les différentes étapes liés à Akonadi, toutes les étapes relatives à l'interface graphique seront réduits au minimum. + Pour rester concentré sur les différentes étapes liés à Akonadi, toutes les étapes relatives à l'interface graphique seront réduites au minimum.
    
  == Preparation ==   == Preparation ==
    
− Nous pouvons rapidement démarrer la création de l'application en utilisant le '''Générateur de modèles pour KDE''', qui peut etre  trouvé dans la section Développement du menu KDE, ou en lançant  '''kapptemplate''' dans un terminal. + Nous pouvons rapidement démarrer la création de l'application en utilisant le '''Générateur de modèles pour KDE''', qui peut être  trouvé dans la section Développement du menu KDE, ou en lançant  '''kapptemplate''' dans un terminal.
    
− en premier, Selectionnez '''Application avec interface graphique pour KDE4'' dans la section C++ du générateur, donnez un nom à votre projet et continuez à travers les pages suivantes pour terminer la création. + en premier, Sélectionnez '''Application avec interface graphique pour KDE4''' dans la section C++ du générateur, donnez un nom à votre projet et continuez à travers les pages suivantes pour terminer la création.
    
  [[Image:TutorialAkonadiDetacherTemplate.png]]   [[Image:TutorialAkonadiDetacherTemplate.png]]





Telliam: /* Preparation */
2010-07-29T10:28:11Z
‎Preparation

				
				
				
				
			
			← Older revision
			Revision as of 10:28, 29 July 2010
			
Line 31:
Line 31:
  == Preparation ==   == Preparation ==
    
− We can kick-start the application by using '''KAppTemplate''', which can be found as '''KDE template generator''' in the development section of the K-menu, or by running '''kapptemplate''' in a terminal window. + Nous pouvons rapidement démarrer la création de l'application en utilisant le '''Générateur de modèles pour KDE''', qui peut etre  trouvé dans la section Développement du menu KDE, ou en lançant  '''kapptemplate''' dans un terminal.
    
− First, we select the '''KDE4 GUI Application''' in the C++ section of the program, give our project a name and continue through the following pages to complete the template creation. + en premier, Selectionnez '''Application avec interface graphique pour KDE4'' dans la section C++ du générateur, donnez un nom à votre projet et continuez à travers les pages suivantes pour terminer la création.
    
  [[Image:TutorialAkonadiDetacherTemplate.png]]   [[Image:TutorialAkonadiDetacherTemplate.png]]

← Older revision		Revision as of 16:07, 19 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Development/Tutorials/Akonadi/Application}}~~	+

	{{TutorialBrowser\|		{{TutorialBrowser\|