/usr/include/KF5/KContacts/kcontacts/vcarddrag.h is in libkf5contacts-dev 16.04.2-1.
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 | /*
This file is part of the KContacts framework.
Copyright (c) 2002-2010 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 KCONTACTS_VCARDDRAG_H
#define KCONTACTS_VCARDDRAG_H
#include "kcontacts_export.h"
#include <kcontacts/addressee.h>
#include <QMimeData>
namespace KContacts
{
/**
@brief Utility function for implementing drag&drop for vCards
See the Qt drag'n'drop documentation.
@since 4.5
*/
namespace VCardDrag
{
/**
Adds the vCard representation as data of the drag object.
@param md the object to set the data on
@param content the vCard data to set
@return Always @c true
*/
KCONTACTS_EXPORT bool populateMimeData(QMimeData *md, const QByteArray &content);
/**
Adds the vCard representation as data of the drag object.
@param md the object to set the data on
@param contacts list of Addressee objects to serialize to vCard
@return @c true if serializing of the given list worked, otherwise @c false
@see VCardConverter::createVCards()
*/
KCONTACTS_EXPORT bool populateMimeData(QMimeData *md, const KContacts::Addressee::List &contacts);
/**
Returns if drag&drop object can be decoded to vCard.
@param md the object to check for vCard data
@return @c true if the given data object contains a vCard MIME type, otherwise @c false
*/
KCONTACTS_EXPORT bool canDecode(const QMimeData *md);
/**
Decodes the drag&drop object to vCard component @p content.
@param md the object to check for vCard data
@param content where to put the vCard data from @p md
@return @c true if there was data for the vCard MIME type, otherwise @c false
@see canDecode()
*/
KCONTACTS_EXPORT bool fromMimeData(const QMimeData *md, QByteArray &content);
/**
Decodes the MIME data @p md and puts the resulting vCard into @p contactss.
@param md the object to check for vCard data
@param contacts where to put the parsed vCards from @p md
@return @c true if there was data for the vCard MIME type and it could be parsed successfully,
otherwise @c false
@see canDecode()
*/
KCONTACTS_EXPORT bool fromMimeData(const QMimeData *md, KContacts::Addressee::List &contacts);
}
}
#endif // VCARDDRAG_H
|