Development/Tutorials/Akonadi/Application - Revision history

AnneW at 18:38, 15 July 2012

2012-07-15T18:38:54Z

Krake: Fix

2011-12-20T16:48:23Z

Fix

Krake: Fix target_link_libraries

2011-12-20T16:45:58Z

Fix target_link_libraries

Neverendingo: Text replace - "" to ""

2011-06-30T10:19:41Z

Text replace - "<syntaxhighlight lang="make">" to "<syntaxhighlight lang="cmake">"

Neverendingo: /* Connecting Views to Akonadi */

2011-06-29T19:28:13Z

‎Connecting Views to Akonadi

Neverendingo: /* Promoting Views */

2011-06-29T19:27:50Z

‎Promoting Views

Neverendingo: /* Preparation */

2011-06-29T19:26:58Z

‎Preparation

Neverendingo: /* Preparation */

2011-06-29T19:26:27Z

‎Preparation

Neverendingo: Text replace - "" to ""

2011-06-29T19:16:04Z

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

Show changes

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


2011-06-29T19:13:39Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 19:13, 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 );

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

	{{TutorialBrowser\|		{{TutorialBrowser\|

← Older revision		Revision as of 16:48, 20 December 2011
Line 425:		Line 425:

	{{note\|Abusing a KDE standard action like this is not recommendable for real applications. For the scope of this tutorial we overlook this as it provides a quick way to setup an action.}}		{{note\|Abusing a KDE standard action like this is not recommendable for real applications. For the scope of this tutorial we overlook this as it provides a quick way to setup an action.}}
		+
		+	To properly link the additional library for file dialog, change the source directory's '''CMakeLists.txt''' to this
		+	<syntaxhighlight lang="cmake">
		+	target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS} ${KDEPIMLIBS_AKONADI_KMIME_LIBS} ${KDEPIMLIBS_KMIME_LIBS} ${KDE4_KIO_LIBS})
		+	</syntaxhighlight>

	In case the [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/klocalizedstring_8h.html#c3e33b6ced4f356d040e165094a5c3d5 i18nc] function or the text used in it are unexpected, see the [[Development/Tutorials/Localization/i18n_Semantics\|Semantic Markup Tutorial]].		In case the [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/klocalizedstring_8h.html#c3e33b6ced4f356d040e165094a5c3d5 i18nc] function or the text used in it are unexpected, see the [[Development/Tutorials/Localization/i18n_Semantics\|Semantic Markup Tutorial]].

@@ Line 220: / Line 220: @@
 Actually, the data type the application will be working on, MIME messages, has an even further specialized model in a type specific sub library.
-To properly link this additional library change the source directory's '''CMakeLists.txt''' to this
+To properly link this additional libraries change the source directory's '''CMakeLists.txt''' to this
 <syntaxhighlight lang="cmake">
-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} ${KDEPIMLIBS_KMIME_LIBS})
 </syntaxhighlight>

@@ Line 221: / Line 221: @@
 To properly link this additional library change the source directory's '''CMakeLists.txt''' to this
-<code>
+<syntaxhighlight lang="make">
 target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS} ${KDEPIMLIBS_AKONADI_KMIME_LIBS})
 </syntaxhighlight>

@@ Line 119: / Line 119: @@
 In the file from the top level directory add the following line
-<code>
+<syntaxhighlight lang="make">
 find_package (KdepimLibs REQUIRED)
 </syntaxhighlight>
@@ Line 125: / Line 125: @@
 and change
-<code>
+<syntaxhighlight lang="make">
 include_directories( ${KDE4_INCLUDES} ${QT_INCLUDES} )
 </syntaxhighlight>
@@ Line 131: / Line 131: @@
 into
-<code>
+<syntaxhighlight lang="make">
 include_directories( ${KDE4_INCLUDES} ${KDEPIMLIBS_INCLUDE_DIRS} ${QT_INCLUDES} )
 </syntaxhighlight>
 In the file from the source directory the line
-<code>
+<syntaxhighlight lang="make">
 target_link_libraries(detacher ${KDE4_KDEUI_LIBS})
 </syntaxhighlight>
@@ Line 142: / Line 142: @@
 has to be changed to
-<code>
+<syntaxhighlight lang="make">
 target_link_libraries(detacher ${KDE4_KDEUI_LIBS} ${KDEPIMLIBS_AKONADI_LIBS})
 </syntaxhighlight>

@@ Line 38: / Line 38: @@
 A look at the generated project top level directory shows us the following files:
-<code>
+<syntaxhighlight lang="bash">
 CMakeLists.txt
 detacher/
@@ Line 68: / Line 68: @@
 From within the generated top level directory:
-<code>
+<syntaxhighlight lang="bash">
 mkdir build
 cd build
@@ Line 78: / Line 78: @@
 From within the generated top level directory:
-<code>
+<syntaxhighlight lang="bash">
 mkdir build
 cd build