/usr/include/akonadi/contact/contacteditor.h is in kdepimlibs5-dev 4:4.8.5-0ubuntu0.3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
This file is part of Akonadi Contact.
Copyright (c) 2009 Tobias Koenig <tokoe@kde.org>
This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Library General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
*/
#ifndef AKONADI_CONTACTEDITOR_H
#define AKONADI_CONTACTEDITOR_H
#include "akonadi-contact_export.h"
#include <QtGui/QWidget>
namespace KABC {
class Addressee;
}
namespace Akonadi {
class AbstractContactEditorWidget;
class Collection;
class Item;
/**
* @short An widget to edit contacts in Akonadi.
*
* This widget provides a way to create a new contact or edit
* an existing contact in Akonadi.
*
* Example for creating a new contact:
*
* @code
*
* using namespace Akonadi;
*
* ContactEditor *editor = new ContactEditor( Akonadi::ContactEditor::CreateMode, this );
*
* ...
*
* if ( !editor->saveContact() ) {
* qDebug() << "Unable to save new contact to storage";
* return;
* }
*
* @endcode
*
* Example for editing an existing contact:
*
* @code
*
* const Akonadi::Item contact = ...;
*
* ContactEditor *editor = new ContactEditor( Akonadi::ContactEditor::EditMode, this );
* editor->loadContact( contact );
*
* ...
*
* if ( !editor->saveContact() ) {
* qDebug() << "Unable to save changed contact to storage";
* return;
* }
*
* @endcode
*
* @author Tobias Koenig <tokoe@kde.org>
* @since 4.4
*/
class AKONADI_CONTACT_EXPORT ContactEditor : public QWidget
{
Q_OBJECT
public:
/**
* Describes the mode of the editor.
*/
enum Mode
{
CreateMode, ///< Creates a new contact
EditMode ///< Edits an existing contact
};
/**
* Creates a new contact editor with the standard editor widget.
*
* @param mode The mode of the editor.
* @param parent The parent widget of the editor.
*/
explicit ContactEditor( Mode mode, QWidget *parent = 0 );
/**
* Creates a new contact editor with a custom editor widget.
*
* @param mode The mode of the editor.
* @param editorWidget The contact editor widget that shall be used for editing.
* @param parent The parent widget of the editor.
*/
ContactEditor( Mode mode, AbstractContactEditorWidget *editorWidget, QWidget *parent = 0 );
/**
* Destroys the contact editor.
*/
virtual ~ContactEditor();
/**
* Sets a @p contact that is used as template in create mode.
*
* The fields of the editor will be prefilled with the content
* of the contact.
*/
void setContactTemplate( const KABC::Addressee &contact );
/**
* Sets the @p addressbook which shall be used to store new
* contacts.
*/
void setDefaultAddressBook( const Akonadi::Collection &addressbook );
public Q_SLOTS:
/**
* Loads the @p contact into the editor.
*/
void loadContact( const Akonadi::Item &contact );
/**
* Saves the contact from the editor back to the storage.
*/
bool saveContact();
Q_SIGNALS:
/**
* This signal is emitted when the @p contact has been saved back
* to the storage.
*/
void contactStored( const Akonadi::Item &contact );
/**
* This signal is emitted when an error occurred during the save.
*
* @p errorMsg The error message.
*/
void error( const QString &errorMsg );
private:
//@cond PRIVATE
class Private;
Private* const d;
Q_PRIVATE_SLOT( d, void itemFetchDone( KJob* ) )
Q_PRIVATE_SLOT( d, void parentCollectionFetchDone( KJob* ) )
Q_PRIVATE_SLOT( d, void storeDone( KJob* ) )
Q_PRIVATE_SLOT( d, void itemChanged( const Akonadi::Item&, const QSet<QByteArray>& ) )
//@endcond
};
}
#endif
|