summaryrefslogtreecommitdiffstats
path: root/lib/store/KoStoreDrag.h
blob: cbd8c40de85fb478cb599a68aaf98eada213efcf (plain)
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
/* This file is part of the KDE project
   Copyright (C) 2002 David Faure <faure@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 koStoreDrag_h
#define koStoreDrag_h

#include <tqdragobject.h>
#include <koffice_export.h>
/**
 * A generic drag object that holds a store (e.g. KoZipStore) in memory.
 * This allows to drag-n-drop and copy-paste complex koffice objects.
 * As per usual with dragobjects, an instance of KoStoreDrag must be
 * created on the "sending" side (dragging or copying). The "receiving"
 * side (dropping or pasting) only uses provides()/canDecode() and tqencodedData().
 *
 * To create the data in memory, create a TQBuffer,
 * then KoStore::createStore( theBuffer, .... ), save the
 * data into the store and delete it. Finally, call setEncodedData().
 */
class KOSTORE_EXPORT KoStoreDrag : public TQStoredDrag
{
public:
    /** Constructor.
     * @param nativeMimeType the app's native mimetype.
     * @param dragSource must be 0 when copying to the clipboard.
     * @param name object name for this drag.
     */
    KoStoreDrag( const char* nativeMimeType, TQWidget *dragSource = 0L, const char *name = 0L );

    static bool canDecode( const char* nativeMimeType, TQMimeSource* e );

    /**
     * Returns the mimetype of the clipboard data for a given application,
     * depending on the application's native mimetype.
     */
    static TQCString mimeType( const char* nativeMimeType );
};

#endif