Akonadi Contacts

standardcontactactionmanager.cpp
1/*
2 This file is part of Akonadi Contact.
3
4 Copyright (c) 2009 - 2010 Tobias Koenig <tokoe@kde.org>
5
6 SPDX-License-Identifier: LGPL-2.0-or-later
7*/
8
9#include "standardcontactactionmanager.h"
10
11#include "contacteditordialog.h"
12#include "contactgroupeditordialog.h"
13
14#include <Akonadi/EntityTreeModel>
15#include <Akonadi/MimeTypeChecker>
16#include <KContacts/Addressee>
17#include <KContacts/ContactGroup>
18
19#include <KActionCollection>
20#include <KLocalizedString>
21#include <KMessageBox>
22#include <QAction>
23
24#include <QItemSelectionModel>
25#include <QPointer>
26
27using namespace Akonadi;
28using namespace Akonadi;
29class Akonadi::StandardContactActionManagerPrivate
30{
31public:
32 StandardContactActionManagerPrivate(KActionCollection *actionCollection, QWidget *parentWidget, StandardContactActionManager *parent)
33 : mActionCollection(actionCollection)
34 , mParentWidget(parentWidget)
35 , mParent(parent)
36 {
37 mGenericManager = new StandardActionManager(actionCollection, parentWidget);
38 mParent->connect(mGenericManager, &StandardActionManager::actionStateUpdated, mParent, &StandardContactActionManager::actionStateUpdated);
39
40 mGenericManager->setMimeTypeFilter(QStringList() << KContacts::Addressee::mimeType() << KContacts::ContactGroup::mimeType());
41
42 mGenericManager->setCapabilityFilter(QStringList() << QStringLiteral("Resource"));
43 }
44
45 ~StandardContactActionManagerPrivate()
46 {
47 delete mGenericManager;
48 }
49
50 void updateGenericAllActions()
51 {
52 updateGenericAction(StandardActionManager::CreateCollection);
53 updateGenericAction(StandardActionManager::CopyCollections);
54 updateGenericAction(StandardActionManager::DeleteCollections);
55 updateGenericAction(StandardActionManager::SynchronizeCollections);
56 updateGenericAction(StandardActionManager::CollectionProperties);
57 updateGenericAction(StandardActionManager::CopyItems);
58 updateGenericAction(StandardActionManager::Paste);
59 updateGenericAction(StandardActionManager::DeleteItems);
60 updateGenericAction(StandardActionManager::ManageLocalSubscriptions);
61 updateGenericAction(StandardActionManager::AddToFavoriteCollections);
62 updateGenericAction(StandardActionManager::RemoveFromFavoriteCollections);
63 updateGenericAction(StandardActionManager::RenameFavoriteCollection);
64 updateGenericAction(StandardActionManager::CopyCollectionToMenu);
65 updateGenericAction(StandardActionManager::CopyItemToMenu);
66 updateGenericAction(StandardActionManager::MoveItemToMenu);
67 updateGenericAction(StandardActionManager::MoveCollectionToMenu);
68 updateGenericAction(StandardActionManager::CutItems);
69 updateGenericAction(StandardActionManager::CutCollections);
70 updateGenericAction(StandardActionManager::CreateResource);
71 updateGenericAction(StandardActionManager::DeleteResources);
72 updateGenericAction(StandardActionManager::ResourceProperties);
73 updateGenericAction(StandardActionManager::SynchronizeResources);
74 updateGenericAction(StandardActionManager::ToggleWorkOffline);
75 updateGenericAction(StandardActionManager::CopyCollectionToDialog);
76 updateGenericAction(StandardActionManager::MoveCollectionToDialog);
77 updateGenericAction(StandardActionManager::CopyItemToDialog);
78 updateGenericAction(StandardActionManager::MoveItemToDialog);
79 updateGenericAction(StandardActionManager::SynchronizeCollectionsRecursive);
80 updateGenericAction(StandardActionManager::MoveCollectionsToTrash);
81 updateGenericAction(StandardActionManager::MoveItemsToTrash);
82 updateGenericAction(StandardActionManager::RestoreCollectionsFromTrash);
83 updateGenericAction(StandardActionManager::RestoreItemsFromTrash);
84 updateGenericAction(StandardActionManager::MoveToTrashRestoreCollection);
85 updateGenericAction(StandardActionManager::MoveToTrashRestoreCollectionAlternative);
86 updateGenericAction(StandardActionManager::MoveToTrashRestoreItem);
87 updateGenericAction(StandardActionManager::MoveToTrashRestoreItemAlternative);
88 updateGenericAction(StandardActionManager::SynchronizeFavoriteCollections);
89 }
90
91 void updateGenericAction(StandardActionManager::Type type)
92 {
93 switch (type) {
94 case Akonadi::StandardActionManager::CreateCollection:
95 mGenericManager->action(Akonadi::StandardActionManager::CreateCollection)->setText(i18n("Add Address Book Folder..."));
96
97 mGenericManager->action(Akonadi::StandardActionManager::CreateCollection)
98 ->setWhatsThis(i18n("Add a new address book folder to the currently selected address book folder."));
99 mGenericManager->setContextText(StandardActionManager::CreateCollection,
100 StandardActionManager::DialogTitle,
101 i18nc("@title:window", "New Address Book Folder"));
102
103 mGenericManager->setContextText(StandardActionManager::CreateCollection,
104 StandardActionManager::ErrorMessageText,
105 ki18n("Could not create address book folder: %1"));
106
107 mGenericManager->setContextText(StandardActionManager::CreateCollection,
108 StandardActionManager::ErrorMessageTitle,
109 i18n("Address book folder creation failed"));
110 mGenericManager->action(Akonadi::StandardActionManager::CreateCollection)
111 ->setProperty("ContentMimeTypes", QStringList() << QStringLiteral("application/x-vnd.kde.contactgroup") << QStringLiteral("text/directory"));
112
113 break;
114 case Akonadi::StandardActionManager::CopyCollections:
115 mGenericManager->setActionText(Akonadi::StandardActionManager::CopyCollections, ki18np("Copy Address Book Folder", "Copy %1 Address Book Folders"));
116 mGenericManager->action(Akonadi::StandardActionManager::CopyCollections)
117 ->setWhatsThis(i18n("Copy the selected address book folders to the clipboard."));
118 break;
119 case Akonadi::StandardActionManager::DeleteCollections:
120 mGenericManager->setActionText(Akonadi::StandardActionManager::DeleteCollections,
121 ki18np("Delete Address Book Folder", "Delete %1 Address Book Folders"));
122 mGenericManager->action(Akonadi::StandardActionManager::DeleteCollections)
123 ->setWhatsThis(i18n("Delete the selected address book folders from the address book."));
124
125 mGenericManager->setContextText(StandardActionManager::DeleteCollections,
126 StandardActionManager::MessageBoxText,
127 ki18np("Do you really want to delete this address book folder and all its sub-folders?",
128 "Do you really want to delete %1 address book folders and all their sub-folders?"));
129 mGenericManager->setContextText(StandardActionManager::DeleteCollections,
130 StandardActionManager::MessageBoxTitle,
131 ki18ncp("@title:window", "Delete address book folder?", "Delete address book folders?"));
132
133 mGenericManager->setContextText(StandardActionManager::DeleteCollections,
134 StandardActionManager::ErrorMessageText,
135 ki18n("Could not delete address book folder: %1"));
136
137 mGenericManager->setContextText(StandardActionManager::DeleteCollections,
138 StandardActionManager::ErrorMessageTitle,
139 i18n("Address book folder deletion failed"));
140 break;
141 case Akonadi::StandardActionManager::SynchronizeCollections:
142 mGenericManager->setActionText(Akonadi::StandardActionManager::SynchronizeCollections,
143 ki18np("Update Address Book Folder", "Update %1 Address Book Folders"));
144 mGenericManager->action(Akonadi::StandardActionManager::SynchronizeCollections)
145 ->setWhatsThis(i18n("Update the content of the selected address book folders."));
146 break;
147 case Akonadi::StandardActionManager::CutCollections:
148 mGenericManager->setActionText(Akonadi::StandardActionManager::CutCollections, ki18np("Cut Address Book Folder", "Cut %1 Address Book Folders"));
149 mGenericManager->action(Akonadi::StandardActionManager::CutCollections)
150 ->setWhatsThis(i18n("Cut the selected address book folders from the address book."));
151 break;
152 case Akonadi::StandardActionManager::CollectionProperties:
153 mGenericManager->action(Akonadi::StandardActionManager::CollectionProperties)->setText(i18n("Folder Properties..."));
154 mGenericManager->action(Akonadi::StandardActionManager::CollectionProperties)
155 ->setWhatsThis(i18n("Open a dialog to edit the properties of the selected address book folder."));
156 mGenericManager->setContextText(StandardActionManager::CollectionProperties,
157 StandardActionManager::DialogTitle,
158 ki18nc("@title:window", "Properties of Address Book Folder %1"));
159 break;
160 case Akonadi::StandardActionManager::CopyItems:
161 mGenericManager->setActionText(Akonadi::StandardActionManager::CopyItems, ki18np("Copy Contact", "Copy %1 Contacts"));
162 mGenericManager->action(Akonadi::StandardActionManager::CopyItems)->setWhatsThis(i18n("Copy the selected contacts to the clipboard."));
163 break;
164 case Akonadi::StandardActionManager::DeleteItems:
165 mGenericManager->setActionText(Akonadi::StandardActionManager::DeleteItems, ki18np("Delete Contact", "Delete %1 Contacts"));
166 mGenericManager->action(Akonadi::StandardActionManager::DeleteItems)->setWhatsThis(i18n("Delete the selected contacts from the address book."));
167 mGenericManager->setContextText(StandardActionManager::DeleteItems,
168 StandardActionManager::MessageBoxText,
169 ki18np("Do you really want to delete the selected contact?", "Do you really want to delete %1 contacts?"));
170
171 mGenericManager->setContextText(StandardActionManager::DeleteItems,
172 StandardActionManager::MessageBoxTitle,
173 ki18ncp("@title:window", "Delete Contact?", "Delete Contacts?"));
174
175 mGenericManager->setContextText(StandardActionManager::DeleteItems, StandardActionManager::ErrorMessageText, ki18n("Could not delete contact: %1"));
176
177 mGenericManager->setContextText(StandardActionManager::DeleteItems, StandardActionManager::ErrorMessageTitle, i18n("Contact deletion failed"));
178 break;
179 case Akonadi::StandardActionManager::CutItems:
180 mGenericManager->setActionText(Akonadi::StandardActionManager::CutItems, ki18np("Cut Contact", "Cut %1 Contacts"));
181 mGenericManager->action(Akonadi::StandardActionManager::CutItems)->setWhatsThis(i18n("Cut the selected contacts from the address book."));
182 break;
183 case Akonadi::StandardActionManager::CreateResource:
184 mGenericManager->action(Akonadi::StandardActionManager::CreateResource)->setText(i18n("Add &Address Book..."));
185 mGenericManager->action(Akonadi::StandardActionManager::CreateResource)
186 ->setWhatsThis(i18n("Add a new address book<p>"
187 "You will be presented with a dialog where you can select "
188 "the type of the address book that shall be added.</p>"));
189 mGenericManager->setContextText(StandardActionManager::CreateResource,
190 StandardActionManager::DialogTitle,
191 i18nc("@title:window", "Add Address Book"));
192
193 mGenericManager->setContextText(StandardActionManager::CreateResource,
194 StandardActionManager::ErrorMessageText,
195 ki18n("Could not create address book: %1"));
196
197 mGenericManager->setContextText(StandardActionManager::CreateResource,
198 StandardActionManager::ErrorMessageTitle,
199 i18n("Address book creation failed"));
200 break;
201 case Akonadi::StandardActionManager::DeleteResources:
202
203 mGenericManager->setActionText(Akonadi::StandardActionManager::DeleteResources, ki18np("&Delete Address Book", "&Delete %1 Address Books"));
204 mGenericManager->action(Akonadi::StandardActionManager::DeleteResources)
205 ->setWhatsThis(i18n("Delete the selected address books<p>"
206 "The currently selected address books will be deleted, "
207 "along with all the contacts and contact groups they contain.</p>"));
208 mGenericManager->setContextText(StandardActionManager::DeleteResources,
209 StandardActionManager::MessageBoxText,
210 ki18np("Do you really want to delete this address book?", "Do you really want to delete %1 address books?"));
211
212 mGenericManager->setContextText(StandardActionManager::DeleteResources,
213 StandardActionManager::MessageBoxTitle,
214 ki18ncp("@title:window", "Delete Address Book?", "Delete Address Books?"));
215
216 break;
217 case Akonadi::StandardActionManager::ResourceProperties:
218
219 mGenericManager->action(Akonadi::StandardActionManager::ResourceProperties)->setText(i18n("Address Book Properties..."));
220 mGenericManager->action(Akonadi::StandardActionManager::ResourceProperties)
221 ->setWhatsThis(i18n("Open a dialog to edit properties of the selected address book."));
222 break;
223 case Akonadi::StandardActionManager::SynchronizeResources:
224 mGenericManager->setActionText(Akonadi::StandardActionManager::SynchronizeResources, ki18np("Update Address Book", "Update %1 Address Books"));
225
226 mGenericManager->action(Akonadi::StandardActionManager::SynchronizeResources)
227 ->setWhatsThis(i18n("Updates the content of all folders of the selected address books."));
228
229 break;
230 case StandardActionManager::Paste:
231 mGenericManager->setContextText(StandardActionManager::Paste, StandardActionManager::ErrorMessageText, ki18n("Could not paste contact: %1"));
232
233 mGenericManager->setContextText(StandardActionManager::Paste, StandardActionManager::ErrorMessageTitle, i18n("Paste failed"));
234 break;
235 default:
236 break;
237 }
238 }
239
240 static bool hasWritableCollection(const QModelIndex &index, const QString &mimeType)
241 {
242 const auto collection = index.data(Akonadi::EntityTreeModel::CollectionRole).value<Akonadi::Collection>();
243 if (collection.isValid()) {
244 if (collection.contentMimeTypes().contains(mimeType) && (collection.rights() & Akonadi::Collection::CanCreateItem)) {
245 return true;
246 }
247 }
248
249 const QAbstractItemModel *model = index.model();
250 if (!model) {
251 return false;
252 }
253
254 for (int row = 0; row < model->rowCount(index); ++row) {
255 if (hasWritableCollection(model->index(row, 0, index), mimeType)) {
256 return true;
257 }
258 }
259
260 return false;
261 }
262
263 bool hasWritableCollection(const QString &mimeType) const
264 {
265 if (!mCollectionSelectionModel) {
266 return false;
267 }
268
269 const QAbstractItemModel *collectionModel = mCollectionSelectionModel->model();
270 for (int row = 0; row < collectionModel->rowCount(); ++row) {
271 if (hasWritableCollection(collectionModel->index(row, 0, QModelIndex()), mimeType)) {
272 return true;
273 }
274 }
275
276 return false;
277 }
278
279 void updateActions()
280 {
281 int itemCount = 0;
282 if (mItemSelectionModel) {
283 itemCount = mItemSelectionModel->selectedRows().count();
284 if (itemCount == 1) {
285 const QModelIndex index = mItemSelectionModel->selectedRows().first();
286 if (index.isValid()) {
287 const QString mimeType = index.data(EntityTreeModel::MimeTypeRole).toString();
288 if (mimeType == KContacts::Addressee::mimeType()) {
289 if (mGenericManager->action(Akonadi::StandardActionManager::CopyItems)) {
290 mGenericManager->setActionText(Akonadi::StandardActionManager::CopyItems, ki18np("Copy Contact", "Copy %1 Contacts"));
291 }
292 QAction *act = mGenericManager->action(Akonadi::StandardActionManager::CopyItemToMenu);
293 if (act) {
294 act->setText(i18n("Copy Contact To"));
295 }
296 act = mGenericManager->action(Akonadi::StandardActionManager::CopyItemToDialog);
297 if (act) {
298 act->setText(i18n("Copy Contact To"));
299 }
300 if (mGenericManager->action(Akonadi::StandardActionManager::DeleteItems)) {
301 mGenericManager->setActionText(Akonadi::StandardActionManager::DeleteItems, ki18np("Delete Contact", "Delete %1 Contacts"));
302 }
303 if (mGenericManager->action(Akonadi::StandardActionManager::CutItems)) {
304 mGenericManager->setActionText(Akonadi::StandardActionManager::CutItems, ki18np("Cut Contact", "Cut %1 Contacts"));
305 }
306 act = mGenericManager->action(Akonadi::StandardActionManager::MoveItemToMenu);
307 if (act) {
308 act->setText(i18n("Move Contact To"));
309 }
310 act = mGenericManager->action(Akonadi::StandardActionManager::MoveItemToDialog);
311 if (act) {
312 act->setText(i18n("Move Contact To"));
313 }
314 act = mActions.value(StandardContactActionManager::EditItem);
315 if (act) {
316 act->setText(i18n("Edit Contact..."));
317 }
318 } else if (mimeType == KContacts::ContactGroup::mimeType()) {
319 if (mGenericManager->action(Akonadi::StandardActionManager::CopyItems)) {
320 mGenericManager->setActionText(Akonadi::StandardActionManager::CopyItems, ki18np("Copy Group", "Copy %1 Groups"));
321 }
322 QAction *act = mGenericManager->action(Akonadi::StandardActionManager::CopyItemToMenu);
323 if (act) {
324 act->setText(i18n("Copy Group To"));
325 }
326 act = mGenericManager->action(Akonadi::StandardActionManager::CopyItemToDialog);
327 if (act) {
328 act->setText(i18n("Copy Group To"));
329 }
330 if (mGenericManager->action(Akonadi::StandardActionManager::DeleteItems)) {
331 mGenericManager->setActionText(Akonadi::StandardActionManager::DeleteItems, ki18np("Delete Group", "Delete %1 Groups"));
332 }
333 if (mGenericManager->action(Akonadi::StandardActionManager::CutItems)) {
334 mGenericManager->setActionText(Akonadi::StandardActionManager::CutItems, ki18np("Cut Group", "Cut %1 Groups"));
335 }
336 act = mGenericManager->action(Akonadi::StandardActionManager::MoveItemToMenu);
337 if (act) {
338 act->setText(i18n("Move Group To"));
339 }
340 act = mGenericManager->action(Akonadi::StandardActionManager::MoveItemToDialog);
341 if (act) {
342 act->setText(i18n("Move Group To"));
343 }
344 act = mActions.value(StandardContactActionManager::EditItem);
345 if (act) {
346 act->setText(i18n("Edit Group..."));
347 }
348 }
349 }
350 }
351 }
352
353 if (mActions.contains(StandardContactActionManager::CreateContact)) {
354 mActions[StandardContactActionManager::CreateContact]->setEnabled(hasWritableCollection(KContacts::Addressee::mimeType()));
355 }
356 if (mActions.contains(StandardContactActionManager::CreateContactGroup)) {
357 mActions[StandardContactActionManager::CreateContactGroup]->setEnabled(hasWritableCollection(KContacts::ContactGroup::mimeType()));
358 }
359
360 if (mActions.contains(StandardContactActionManager::EditItem)) {
361 bool canEditItem = true;
362
363 // only one selected item can be edited
364 canEditItem = canEditItem && (itemCount == 1);
365
366 // check whether parent collection allows changing the item
367 const QModelIndexList rows = mItemSelectionModel->selectedRows();
368 if (rows.count() == 1) {
369 const QModelIndex index = rows.first();
370 const auto parentCollection = index.data(EntityTreeModel::ParentCollectionRole).value<Collection>();
371 if (parentCollection.isValid()) {
372 canEditItem = canEditItem && (parentCollection.rights() & Collection::CanChangeItem);
373 }
374 }
375
376 mActions.value(StandardContactActionManager::EditItem)->setEnabled(canEditItem);
377 }
378
379 Q_EMIT mParent->actionStateUpdated();
380 }
381
382 Collection selectedCollection() const
383 {
384 if (!mCollectionSelectionModel) {
385 return {};
386 }
387
388 if (mCollectionSelectionModel->selectedIndexes().isEmpty()) {
389 return {};
390 }
391
392 const QModelIndex index = mCollectionSelectionModel->selectedIndexes().first();
393 if (!index.isValid()) {
394 return {};
395 }
396
397 return index.data(EntityTreeModel::CollectionRole).value<Collection>();
398 }
399
400 void slotCreateContact()
401 {
402 if (mInterceptedActions.contains(StandardContactActionManager::CreateContact)) {
403 return;
404 }
405
406 QPointer<Akonadi::ContactEditorDialog> dlg = new Akonadi::ContactEditorDialog(Akonadi::ContactEditorDialog::CreateMode, mParentWidget);
407 dlg->setDefaultAddressBook(selectedCollection());
408 dlg->exec();
409 delete dlg;
410 }
411
412 void slotCreateContactGroup()
413 {
414 if (mInterceptedActions.contains(StandardContactActionManager::CreateContactGroup)) {
415 return;
416 }
417
418 QPointer<Akonadi::ContactGroupEditorDialog> dlg = new Akonadi::ContactGroupEditorDialog(Akonadi::ContactGroupEditorDialog::CreateMode, mParentWidget);
419 dlg->setDefaultAddressBook(selectedCollection());
420 dlg->exec();
421 delete dlg;
422 }
423
424 void slotEditItem()
425 {
426 if (mInterceptedActions.contains(StandardContactActionManager::EditItem)) {
427 return;
428 }
429
430 if (!mItemSelectionModel) {
431 return;
432 }
433
434 if (mItemSelectionModel->selectedIndexes().isEmpty()) {
435 return;
436 }
437
438 const QModelIndex index = mItemSelectionModel->selectedIndexes().first();
439 if (!index.isValid()) {
440 return;
441 }
442
443 const Item item = index.data(EntityTreeModel::ItemRole).value<Item>();
444 if (!item.isValid()) {
445 return;
446 }
447
448 if (Akonadi::MimeTypeChecker::isWantedItem(item, KContacts::Addressee::mimeType())) {
449 QPointer<Akonadi::ContactEditorDialog> dlg = new Akonadi::ContactEditorDialog(Akonadi::ContactEditorDialog::EditMode, mParentWidget);
450 QObject::connect(dlg.data(), &Akonadi::ContactEditorDialog::error, mParent, [this](const QString &error) {
451 slotContactEditorError(error);
452 });
453 dlg->setContact(item);
454 dlg->exec();
455 delete dlg;
456 } else if (Akonadi::MimeTypeChecker::isWantedItem(item, KContacts::ContactGroup::mimeType())) {
457 QPointer<Akonadi::ContactGroupEditorDialog> dlg = new Akonadi::ContactGroupEditorDialog(Akonadi::ContactGroupEditorDialog::EditMode, mParentWidget);
458 dlg->setContactGroup(item);
459 dlg->exec();
460 delete dlg;
461 }
462 }
463
464 void slotContactEditorError(const QString &error)
465 {
466 KMessageBox::error(mParentWidget, i18n("Contact cannot be stored: %1", error), i18nc("@title:window", "Failed to store contact"));
467 }
468
469 KActionCollection *const mActionCollection;
470 QWidget *const mParentWidget;
471 StandardActionManager *mGenericManager = nullptr;
472 QItemSelectionModel *mCollectionSelectionModel = nullptr;
473 QItemSelectionModel *mItemSelectionModel = nullptr;
474 QHash<StandardContactActionManager::Type, QAction *> mActions;
475 QSet<StandardContactActionManager::Type> mInterceptedActions;
476 StandardContactActionManager *const mParent;
477};
478
479StandardContactActionManager::StandardContactActionManager(KActionCollection *actionCollection, QWidget *parent)
480 : QObject(parent)
481 , d(new StandardContactActionManagerPrivate(actionCollection, parent, this))
482{
483}
484
485StandardContactActionManager::~StandardContactActionManager() = default;
486
487void StandardContactActionManager::setCollectionSelectionModel(QItemSelectionModel *selectionModel)
488{
489 d->mCollectionSelectionModel = selectionModel;
490 d->mGenericManager->setCollectionSelectionModel(selectionModel);
491
492 connect(selectionModel->model(), &QAbstractItemModel::rowsInserted, this, [this]() {
493 d->updateActions();
494 });
495 connect(selectionModel->model(), &QAbstractItemModel::rowsRemoved, this, [this]() {
496 d->updateActions();
497 });
498 connect(selectionModel, &QItemSelectionModel::selectionChanged, this, [this]() {
499 d->updateActions();
500 });
501
502 d->updateActions();
503}
504
505void StandardContactActionManager::setItemSelectionModel(QItemSelectionModel *selectionModel)
506{
507 d->mItemSelectionModel = selectionModel;
508 d->mGenericManager->setItemSelectionModel(selectionModel);
509
510 connect(selectionModel, &QItemSelectionModel::selectionChanged, this, [this]() {
511 d->updateActions();
512 });
513
514 d->updateActions();
515}
516
517QAction *StandardContactActionManager::createAction(Type type)
518{
519 QAction *action = d->mActions.value(type);
520 if (action) {
521 return action;
522 }
523
524 switch (type) {
525 case CreateContact:
526 action = new QAction(d->mParentWidget);
527 action->setIcon(QIcon::fromTheme(QStringLiteral("contact-new")));
528 action->setText(i18n("New &Contact..."));
529 action->setWhatsThis(i18n(
530 "Create a new contact<p>You will be presented with a dialog where you can add data about a person, including addresses and phone numbers.</p>"));
531 d->mActions.insert(CreateContact, action);
532 d->mActionCollection->addAction(QStringLiteral("akonadi_contact_create"), action);
533 d->mActionCollection->setDefaultShortcut(action, QKeySequence(Qt::CTRL | Qt::Key_N));
534 connect(action, &QAction::triggered, this, [this]() {
535 d->slotCreateContact();
536 });
537 break;
538 case CreateContactGroup:
539 action = new QAction(d->mParentWidget);
540 action->setIcon(QIcon::fromTheme(QStringLiteral("user-group-new")));
541 action->setText(i18n("New &Group..."));
542 action->setWhatsThis(i18n("Create a new group<p>You will be presented with a dialog where you can add a new group of contacts.</p>"));
543 d->mActions.insert(CreateContactGroup, action);
544 d->mActionCollection->addAction(QStringLiteral("akonadi_contact_group_create"), action);
545 d->mActionCollection->setDefaultShortcut(action, QKeySequence(Qt::CTRL | Qt::Key_G));
546 connect(action, &QAction::triggered, this, [this]() {
547 d->slotCreateContactGroup();
548 });
549 break;
550 case EditItem:
551 action = new QAction(d->mParentWidget);
552 action->setIcon(QIcon::fromTheme(QStringLiteral("document-edit")));
553 action->setText(i18n("Edit Contact..."));
554 action->setWhatsThis(
555 i18n("Edit the selected contact<p>You will be presented with a dialog where you can edit the data stored about a person, including addresses and "
556 "phone numbers.</p>"));
557 action->setEnabled(false);
558 d->mActions.insert(EditItem, action);
559 d->mActionCollection->addAction(QStringLiteral("akonadi_contact_item_edit"), action);
560 d->mActionCollection->setDefaultShortcut(action, QKeySequence(Qt::CTRL | Qt::Key_E));
561
562 connect(action, &QAction::triggered, this, [this]() {
563 d->slotEditItem();
564 });
565 break;
566 default:
567 Q_ASSERT(false); // should never happen
568 break;
569 }
570
571 return action;
572}
573
574QAction *StandardContactActionManager::createAction(StandardActionManager::Type type)
575{
576 QAction *act = d->mGenericManager->action(type);
577 if (!act) {
578 act = d->mGenericManager->createAction(type);
579 }
580 d->updateGenericAction(type);
581 return act;
582}
583
584void StandardContactActionManager::createAllActions()
585{
586 createAction(CreateContact);
587 createAction(CreateContactGroup);
588 createAction(EditItem);
589
590 d->mGenericManager->createAllActions();
591 d->updateGenericAllActions();
592
593 d->updateActions();
594}
595
596QAction *StandardContactActionManager::action(Type type) const
597{
598 if (d->mActions.contains(type)) {
599 return d->mActions.value(type);
600 }
601
602 return nullptr;
603}
604
605QAction *StandardContactActionManager::action(StandardActionManager::Type type) const
606{
607 return d->mGenericManager->action(type);
608}
609
610void StandardContactActionManager::setActionText(StandardActionManager::Type type, const KLocalizedString &text)
611{
612 d->mGenericManager->setActionText(type, text);
613}
614
615void StandardContactActionManager::interceptAction(Type type, bool intercept)
616{
617 if (intercept) {
618 d->mInterceptedActions.insert(type);
619 } else {
620 d->mInterceptedActions.remove(type);
621 }
622}
623
624void StandardContactActionManager::interceptAction(StandardActionManager::Type type, bool intercept)
625{
626 d->mGenericManager->interceptAction(type, intercept);
627}
628
629Akonadi::Collection::List StandardContactActionManager::selectedCollections() const
630{
631 return d->mGenericManager->selectedCollections();
632}
633
634Akonadi::Item::List StandardContactActionManager::selectedItems() const
635{
636 return d->mGenericManager->selectedItems();
637}
638
639void StandardContactActionManager::setCollectionPropertiesPageNames(const QStringList &names)
640{
641 d->mGenericManager->setCollectionPropertiesPageNames(names);
642}
643
644#include "moc_standardcontactactionmanager.cpp"
Akonadi::Collection::List
QList< Collection > List
Akonadi::ContactEditorDialog::EditMode
@ EditMode
Edits an existing contact.
Definition contacteditordialog.h:74
Akonadi::ContactEditorDialog::CreateMode
@ CreateMode
Creates a new contact.
Definition contacteditordialog.h:73
Akonadi::ContactEditorDialog::error
void error(const QString &errMsg)
This signal is emitted whenever a contact is not updated or stored.
Akonadi::ContactGroupEditorDialog::CreateMode
@ CreateMode
Creates a new contact group.
Definition contactgroupeditordialog.h:71
Akonadi::ContactGroupEditorDialog::EditMode
@ EditMode
Edits an existing contact group.
Definition contactgroupeditordialog.h:72
Akonadi::Item::List
QList< Item > List
Akonadi::MimeTypeChecker::isWantedItem
bool isWantedItem(const Item &item) const
Akonadi::StandardContactActionManager::EditItem
@ EditItem
Edits the selected contact resp. contact group.
Definition standardcontactactionmanager.h:45
Akonadi::StandardContactActionManager::setCollectionPropertiesPageNames
void setCollectionPropertiesPageNames(const QStringList &names)
Definition standardcontactactionmanager.cpp:639
Akonadi::StandardContactActionManager::StandardContactActionManager
StandardContactActionManager(KActionCollection *actionCollection, QWidget *parent=nullptr)
Creates a new standard contact action manager.
Definition standardcontactactionmanager.cpp:479
Akonadi::StandardContactActionManager::action
QAction * action(Type type) const
Returns the action of the given type, 0 if it has not been created (yet).
Definition standardcontactactionmanager.cpp:596
Akonadi::StandardContactActionManager::setCollectionSelectionModel
void setCollectionSelectionModel(QItemSelectionModel *selectionModel)
Sets the collection selection model based on which the collection related actions should operate.
Definition standardcontactactionmanager.cpp:487
Akonadi::StandardContactActionManager::selectedItems
Akonadi::Item::List selectedItems() const
Returns the list of items that are currently selected.
Definition standardcontactactionmanager.cpp:634
Akonadi::StandardContactActionManager::selectedCollections
Akonadi::Collection::List selectedCollections() const
Returns the list of collections that are currently selected.
Definition standardcontactactionmanager.cpp:629
Akonadi::StandardContactActionManager::actionStateUpdated
void actionStateUpdated()
This signal is emitted whenever the action state has been updated.
Akonadi::StandardContactActionManager::createAllActions
void createAllActions()
Convenience method to create all standard actions.
Definition standardcontactactionmanager.cpp:584
Akonadi::StandardContactActionManager::~StandardContactActionManager
~StandardContactActionManager() override
Destroys the standard contact action manager.
Akonadi::StandardContactActionManager::createAction
QAction * createAction(Type type)
Creates the action of the given type and adds it to the action collection specified in the constructo...
Definition standardcontactactionmanager.cpp:517
Akonadi::StandardContactActionManager::setItemSelectionModel
void setItemSelectionModel(QItemSelectionModel *selectionModel)
Sets the item selection model based on which the item related actions should operate.
Definition standardcontactactionmanager.cpp:505
Akonadi::StandardContactActionManager::interceptAction
void interceptAction(Type type, bool intercept=true)
Sets whether the default implementation for the given action type shall be executed when the action i...
Definition standardcontactactionmanager.cpp:615
Akonadi::StandardContactActionManager::setActionText
void setActionText(Akonadi::StandardActionManager::Type type, const KLocalizedString &text)
Sets the label of the action type to text, which is used during updating the action state and substit...
Definition standardcontactactionmanager.cpp:610
KContacts::Addressee::mimeType
static QString mimeType()
KContacts::ContactGroup::mimeType
static QString mimeType()
ki18np
KLocalizedString KI18N_EXPORT ki18np(const char *singular, const char *plural)
ki18n
KLocalizedString KI18N_EXPORT ki18n(const char *text)
i18nc
QString i18nc(const char *context, const char *text, const TYPE &arg...)
ki18ncp
KLocalizedString KI18N_EXPORT ki18ncp(const char *context, const char *singular, const char *plural)
ki18nc
KLocalizedString KI18N_EXPORT ki18nc(const char *context, const char *text)
i18n
QString i18n(const char *text, const TYPE &arg...)
Akonadi
A widget for editing the display name of a contact.
KCalUtils::ICalDrag::mimeType
KCALUTILS_EXPORT QString mimeType()
KMessageBox::error
void error(QWidget *parent, const QString &text, const QString &title, const KGuiItem &buttonOk, Options options=Notify)
QAbstractItemModel::index
virtual QModelIndex index(int row, int column, const QModelIndex &parent) const const=0
QAbstractItemModel::rowCount
virtual int rowCount(const QModelIndex &parent) const const=0
QAbstractItemModel::rowsInserted
void rowsInserted(const QModelIndex &parent, int first, int last)
QAbstractItemModel::rowsRemoved
void rowsRemoved(const QModelIndex &parent, int first, int last)
QAction::setText
void setText(const QString &text)
QAction::triggered
void triggered(bool checked)
QIcon::fromTheme
QIcon fromTheme(const QString &name)
QItemSelectionModel::model
QAbstractItemModel * model()
QItemSelectionModel::selectionChanged
void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)
QModelIndex::data
QVariant data(int role) const const
QModelIndex::isValid
bool isValid() const const
QModelIndex::model
const QAbstractItemModel * model() const const
QObject::QObject
QObject(QObject *parent)
QObject::connect
QMetaObject::Connection connect(const QObject *sender, PointerToMemberFunction signal, Functor functor)
QObject::parent
QObject * parent() const const
QPointer::data
T * data() const const
QVariant::toString
QString toString() const const
QVariant::value
T value() const const
This file is part of the KDE documentation.
Documentation copyright © 1996-2025 The KDE developers.
Generated on Fri May 2 2025 11:52:44 by doxygen 1.13.2 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.