/usr/include/akonadi/contact/contacteditordialog.h is in kdepimlibs5-dev 4:4.13.0-0ubuntu1.
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 | /*
This file is part of Akonadi Contact.
Copyright (c) 2007-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_CONTACTEDITORDIALOG_H
#define AKONADI_CONTACTEDITORDIALOG_H
#include "akonadi-contact_export.h"
#include <kdialog.h>
class QAbstractItemModel;
namespace Akonadi {
class AbstractContactEditorWidget;
class ContactEditor;
class Collection;
class Item;
/**
* @short A dialog for creating or editing a contact in Akonadi.
*
* This dialog 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;
*
* ContactEditorDialog *dlg = new ContactEditorDialog( ContactEditorDialog::CreateMode, this );
* connect( dlg, SIGNAL( contactStored( const Akonadi::Item& ) ),
* this, SLOT( contactStored( const Akonadi::Item& ) ) );
* dlg->show();
*
*
* @endcode
*
* Example for editing an existing contact:
*
* @code
*
* using namespace Akonadi;
*
* const Item contact = ...;
*
* ContactEditorDialog *dlg = new ContactEditorDialog( ContactEditorDialog::EditMode, this );
* connect( dlg, SIGNAL( contactStored( const Akonadi::Item& ) ),
* this, SLOT( contactStored( const Akonadi::Item& ) ) );
* dlg->setContact( contact );
* dlg->show();
*
* @endcode
*
* @author Tobias Koenig <tokoe@kde.org>
* @since 4.4
*/
class AKONADI_CONTACT_EXPORT ContactEditorDialog : public KDialog
{
Q_OBJECT
public:
/**
* Describes the mode of the editor dialog.
*/
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 dialog with the standard editor widget.
*
* @param mode The mode of the dialog.
* @param parent The parent widget of the dialog.
*/
explicit ContactEditorDialog( Mode mode, QWidget *parent = 0 );
/**
* Creates a new contact editor dialog with a custom editor widget.
*
* @param mode The mode of the dialog.
* @param editorWidget The contact editor widget that shall be used for editing.
* @param parent The parent widget of the dialog.
*/
ContactEditorDialog( 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 The mode of displaying: full or vcard
* @param parent The parent widget of the dialog.
* @since 4.10
*/
ContactEditorDialog( Mode mode, DisplayMode displayMode, QWidget *parent = 0 );
/**
* Destroys the contact editor dialog.
*/
~ContactEditorDialog();
/**
* Sets the @p contact to edit when in EditMode.
* @param contact the contact to edit
* @note The contact item just must have a uid set, all
* other data are fetched by the dialog automatically.
*/
void setContact( const Akonadi::Item &contact );
/**
* Sets the @p addressbook that shall be selected as default in create mode.
*/
void setDefaultAddressBook( const Akonadi::Collection &addressbook );
/**
* Returns the ContactEditor that is used by this dialog.
*/
ContactEditor* editor() const;
Q_SIGNALS:
/**
* This signal is emitted whenever a contact was updated or stored.
*
* @param contact The data reference of the contact.
*/
void contactStored( const Akonadi::Item &contact );
/**
* This signal is emitted whenever a contact is not updated or stored.
*
* @param errMsg The error during updating or storing contact.
*/
void error(const QString& errMsg);
public Q_SLOTS:
void accept();
private:
//@cond PRIVATE
class Private;
Private* const d;
Q_PRIVATE_SLOT( d, void slotOkClicked() )
Q_PRIVATE_SLOT( d, void slotCancelClicked() )
Q_PRIVATE_SLOT( d, void slotFinish() )
//@endcond
};
}
#endif
|