X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/fa988586bc923b33497cbc97aaac07fc93a4ca83..38c34eeca:/src/views/tooltips/tooltipmanager.h diff --git a/src/views/tooltips/tooltipmanager.h b/src/views/tooltips/tooltipmanager.h index f6d8b8f26..9aee295ff 100644 --- a/src/views/tooltips/tooltipmanager.h +++ b/src/views/tooltips/tooltipmanager.h @@ -1,32 +1,21 @@ -/******************************************************************************* - * Copyright (C) 2008 by Konstantin Heil * - * * - * This program is free software; you can redistribute it and/or modify * - * it under the terms of the GNU General Public License as published by * - * the Free Software Foundation; either version 2 of the License, or * - * (at your option) any later version. * - * * - * This program 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 General Public License for more details. * - * * - * You should have received a copy of the GNU General Public License * - * along with this program; if not, write to the * - * Free Software Foundation, Inc., * - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * - *******************************************************************************/ +/* + * SPDX-FileCopyrightText: 2008 Konstantin Heil + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ #ifndef TOOLTIPMANAGER_H #define TOOLTIPMANAGER_H +#include + #include #include -#include - -class FileMetaDataToolTip; +class DolphinFileMetaDataWidget; +class KToolTipWidget; class QTimer; +class QWindow; /** * @brief Manages the tooltips for an item view. @@ -40,25 +29,34 @@ class ToolTipManager : public QObject Q_OBJECT public: - explicit ToolTipManager(QWidget* parent); - virtual ~ToolTipManager(); + enum class HideBehavior { Instantly, Later }; + + explicit ToolTipManager(QWidget *parent); + ~ToolTipManager() override; /** * Triggers the showing of the tooltip for the item \p item * where the item has the maximum boundaries of \p itemRect. * The tooltip manager takes care that the tooltip is shown - * slightly delayed. + * slightly delayed and with a proper \p transientParent. */ - void showToolTip(const KFileItem& item, const QRectF& itemRect); + void showToolTip(const KFileItem &item, const QRectF &itemRect, QWindow *transientParent); /** * Hides the currently shown tooltip. */ - void hideToolTip(); + void hideToolTip(const HideBehavior behavior = HideBehavior::Later); + +Q_SIGNALS: + /** + * Is emitted when the user clicks a tag or a link + * in the metadata widget. + */ + void urlActivated(const QUrl &url); -private slots: +private Q_SLOTS: void startContentRetrieval(); - void setPreviewPix(const KFileItem& item, const QPixmap& pix); + void setPreviewPix(const KFileItem &item, const QPixmap &pix); void previewFailed(); void slotMetaDataRequestFinished(); void showToolTip(); @@ -66,13 +64,22 @@ private slots: private: /// Timeout from requesting a tooltip until the tooltip /// should be shown - QTimer* m_showToolTipTimer; + QTimer *m_showToolTipTimer; /// Timeout from requesting a tooltip until the retrieving of /// the tooltip content like preview and meta data gets started. - QTimer* m_contentRetrievalTimer; + QTimer *m_contentRetrievalTimer; + + /// Transient parent of the tooltip, mandatory on Wayland. + QWindow *m_transientParent; + + QScopedPointer m_tooltipWidget; + DolphinFileMetaDataWidget *m_fileMetaDataWidget = nullptr; - FileMetaDataToolTip* m_fileMetaDataToolTip; + /// Whether ownership of the metadata widget was transferred + /// over to the KToolTipWidget (i.e. we should not delete it + /// anymore) + bool m_fileMetaDatWidgetOwnershipTransferred = false; bool m_toolTipRequested; bool m_metaDataRequested;