/usr/include/akonadi/contact/contacteditor.h is in kdepimlibs5-dev 4:4.14.10-1ubuntu7.
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 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 | /*
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 <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 );
*
* ...
*
* editor->saveContactInAddressBook();
*
* @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
};
enum DisplayMode {
FullMode, ///< Show all pages
VCardMode ///< Show just pages with elements stored in vcard.
};
/**
* 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 );
/**
* Creates a new contact editor dialog with a custom editor widget.
*
* @param mode The mode of the dialog.
* @param displayMode mode for displaying the editor
* @param parent The parent widget of the dialog.
* @since 4.10
*/
ContactEditor( Mode mode, DisplayMode displayMode, 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.
* @param contact the contact to use as template content
*/
void setContactTemplate( const KABC::Addressee &contact );
/**
* Sets the @p addressbook which shall be used to store new
* contacts.
*/
void setDefaultAddressBook( const Akonadi::Collection &addressbook );
/**
* @since 4.10
* @brief ContactEditor::contact
* @return
*/
KABC::Addressee contact();
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.
* @deprecated use saveContactInAddressBook. We can't get contactStored and error infos.
* Remove it for KDE SC5
*/
AKONADI_CONTACT_DEPRECATED bool saveContact();
/**
* Save the contact from the editor back to the storage. And return error.
* Need to connect to finished() signal, to keep time to emit signal.
* @since 4.11
*/
void saveContactInAddressBook();
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.
* @param errorMsg The error message.
* @since 4.11
*/
void error( const QString &errorMsg );
/**
* @brief finished
* @since 4.11
*/
void finished();
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
|