File indexing completed on 2024-12-08 03:39:25

0001 /*  This file is part of the KDE libraries
0002     SPDX-FileCopyrightText: 1999 Steffen Hansen <hansen@kde.org>
0003     SPDX-FileCopyrightText: 2005 Joseph Wenninger <jowenn@kde.org>
0004 
0005     SPDX-License-Identifier: LGPL-2.0-or-later
0006 */
0007 
0008 #ifndef _KCOLORMIMEDATA_H
0009 #define _KCOLORMIMEDATA_H
0010 
0011 #include <kguiaddons_export.h>
0012 
0013 class QColor;
0014 class QDrag;
0015 class QMimeData;
0016 class QObject;
0017 
0018 /**
0019  * Drag-and-drop and clipboard mimedata manipulation for QColor objects. The according MIME type
0020  * is set to application/x-color.
0021  *
0022  * See the Qt drag'n'drop documentation.
0023  */
0024 namespace KColorMimeData
0025 {
0026 /**
0027  * Sets the color and text representation fields for the specified color in the mimedata object:
0028  * application/x-color and text/plain types are set
0029  */
0030 KGUIADDONS_EXPORT void populateMimeData(QMimeData *mimeData, const QColor &color);
0031 
0032 /**
0033  * Returns true if the MIME data @p mimeData contains a color object.
0034  * First checks for application/x-color and if that fails, for a text/plain entry, which
0035  * represents a color in the format \#hexnumbers
0036  */
0037 KGUIADDONS_EXPORT bool canDecode(const QMimeData *mimeData);
0038 
0039 /**
0040  * Decodes the MIME data @p mimeData and returns the resulting color.
0041  * First tries application/x-color and if that fails, a text/plain entry, which
0042  * represents a color in the format \#hexnumbers. If this fails too,
0043  * an invalid QColor object is returned, use QColor::isValid() to test it.
0044  */
0045 KGUIADDONS_EXPORT QColor fromMimeData(const QMimeData *mimeData);
0046 
0047 /**
0048  * Creates a color drag object. Either you have to start this drag or delete it
0049  * The drag object's mime data has the application/x-color and text/plain type set and a pixmap
0050  * filled with the specified color, which is going to be displayed next to the mouse cursor
0051  */
0052 KGUIADDONS_EXPORT QDrag *createDrag(const QColor &color, QObject *dragsource);
0053 }
0054 
0055 #endif // _KCOLORMIMEDATA_H