ICPreviewPopup.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <QLabel>
#include <QPointer>
#include <QTimer>
#include <QWidget>
 
class IC;

class ICPreviewPopup : public QWidget
{
    Q_OBJECT
 
    // Test-only seam: executeShow() is the real timer-fired slot, but waiting out the real
    // 1-second m_showTimer in a test is slow and non-deterministic. Calling it directly lets
    // tests drive the exact same logic showForIC() would eventually trigger, synchronously.
    friend class TestICUnit;
 
public:
    static constexpr int MaxWidth = 500;
    static constexpr int MaxHeight = 350;

    static constexpr int MaxElementCount = 500;

    explicit ICPreviewPopup(QWidget *parent = nullptr);

    void showForIC(IC *ic, const QPoint &screenPos);

    void scheduleHide();

    void cancelHide();

    void updatePendingPos(const QPoint &screenPos);

    IC *pendingIC() const;

    bool isShowActiveFor(const IC *ic) const;

    static QPoint clampedPopupPos(const QPoint &cursorPos, const QSize &popupSize, const QRect &availableGeometry);
 
protected:
    void enterEvent(QEnterEvent *event) override;

    void leaveEvent(QEvent *event) override;
 
private:
    void executeShow();
 
    QLabel *m_titleLabel;   
    QLabel *m_imageLabel;
    QTimer m_hideTimer;
    QTimer m_showTimer;
    QPointer<IC> m_pendingIC;   
    QPoint m_pendingPos;
};