/usr/include/akonadi/collectionrequester.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 | /*
Copyright 2008 Ingo Klöcker <kloecker@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_COLLECTIONREQUESTER_H
#define AKONADI_COLLECTIONREQUESTER_H
#include "akonadi_export.h"
#include <akonadi/collection.h>
#include <akonadi/collectiondialog.h>
#include <khbox.h>
namespace Akonadi {
/**
* @short A widget to request an Akonadi collection from the user.
*
* This class is a widget showing a read-only lineedit displaying
* the currently chosen collection and a button invoking a dialog
* for choosing a collection.
*
* Example:
*
* @code
*
* // create a collection requester to select a collection of contacts
* Akonadi::CollectionRequester requester( Akonadi::Collection::root(), this );
* requester.setMimeTypeFilter( QStringList() << QString( "text/directory" ) );
*
* ...
*
* const Akonadi::Collection collection = requester.collection();
* if ( collection.isValid() ) {
* ...
* }
*
* @endcode
*
* @author Ingo Klöcker <kloecker@kde.org>
* @since 4.3
*/
class AKONADI_EXPORT CollectionRequester : public KHBox
{
Q_OBJECT
Q_DISABLE_COPY( CollectionRequester )
public:
/**
* Creates a collection requester.
*
* @param parent The parent widget.
*/
explicit CollectionRequester( QWidget *parent = 0 );
/**
* Creates a collection requester with an initial @p collection.
*
* @param collection The initial collection.
* @param parent The parent widget.
*/
explicit CollectionRequester( const Akonadi::Collection &collection, QWidget *parent = 0 );
/**
* Destroys the collection requester.
*/
~CollectionRequester();
/**
* Returns the currently chosen collection, or an empty collection if none
* none was chosen.
*/
Akonadi::Collection collection() const;
/**
* Sets the mime types any of which the selected collection shall support.
*/
void setMimeTypeFilter( const QStringList &mimeTypes );
/**
* Returns the mime types any of which the selected collection shall support.
*/
QStringList mimeTypeFilter() const;
/**
* Sets the access @p rights that the listed collections shall match with.
* @param rights the access rights to set
* @since 4.4
*/
void setAccessRightsFilter( Collection::Rights rights );
/**
* Returns the access rights that the listed collections shall match with.
* @since 4.4
*/
Collection::Rights accessRightsFilter() const;
/**
* @param options new collection dialog options
*/
void changeCollectionDialogOptions( CollectionDialog::CollectionDialogOptions options );
public Q_SLOTS:
/**
* Sets the @p collection of the requester.
*/
void setCollection( const Akonadi::Collection &collection );
Q_SIGNALS:
/**
* This signal is emitted when the selected collection has changed.
*
* @param collection The selected collection.
*
* @since 4.5
*/
void collectionChanged( const Akonadi::Collection &collection );
private:
class Private;
Private * const d;
Q_PRIVATE_SLOT( d, void _k_slotOpenDialog() )
Q_PRIVATE_SLOT( d, void _k_collectionReceived( KJob *job ) )
Q_PRIVATE_SLOT( d, void _k_collectionsNamesReceived( KJob *job ) );
};
} // namespace Akonadi
#endif // AKONADI_COLLECTIONREQUESTER_H
|