regionframeitem.h

Go to the documentation of this file.

/* ============================================================
*
* This file is a part of digiKam project
* https://www.digikam.org
*
* Date        : 2010-09-09
* Description : tag region frame
*
* Copyright (C) 2007      by Aurelien Gateau <agateau at kde dot org>
* Copyright (C) 2010-2011 by Marcel Wiesweg <marcel dot wiesweg at gmx dot de>
*
* 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, 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.
*
* ============================================================ */
 
#ifndef DIGIKAM_REGION_FRAME_ITEM_H
#define DIGIKAM_REGION_FRAME_ITEM_H
 
// Qt includes
 
#include <QFlags>
 
// Local includes
 
#include "dimgchilditem.h"
#include "digikam_export.h"
 
class QWidget;
 
namespace Digikam
{
 
class DIGIKAM_EXPORT RegionFrameItem : public DImgChildItem         // clazy:exclude=ctor-missing-parent-argument
{
    Q_OBJECT
 
public:
 
    enum Flag
    {
        NoFlags           = 0,
        ShowResizeHandles = 1 << 0,
        MoveByDrag        = 1 << 1,
 
        GeometryEditable  = ShowResizeHandles | MoveByDrag
    };
    Q_DECLARE_FLAGS(Flags, Flag)
 
public:
 
    explicit RegionFrameItem(QGraphicsItem* const parent);
    ~RegionFrameItem()                                      override;
 
    void  setFlags(Flags flags);
    void  changeFlags(Flags flags, bool addOrRemove);
    Flags flags()                                     const;
 
    void             setHudWidget(QGraphicsWidget* const hudWidget);
    void             setHudWidget(QWidget* const widget, Qt::WindowFlags wFlags = Qt::WindowFlags());
    QGraphicsWidget* hudWidget()                      const;
    void             setHudWidgetVisible(bool visible);
 
    void setFixedRatio(double ratio);
 
    void setRectInSceneCoordinatesAdjusted(const QRectF& rect);
 
    QRectF boundingRect()                             const override;
 
public Q_SLOTS:
 
    void setViewportRect(const QRectF& rect);
 
Q_SIGNALS:
 
    void geometryEdited();
 
protected:
 
    void paint(QPainter* painter,
               const QStyleOptionGraphicsItem* option,
               QWidget* widget = nullptr)                   override;
    void mousePressEvent(QGraphicsSceneMouseEvent*)         override;
    void mouseMoveEvent(QGraphicsSceneMouseEvent*)          override;
    void mouseReleaseEvent(QGraphicsSceneMouseEvent*)       override;
    void hoverEnterEvent(QGraphicsSceneHoverEvent* event)   override;
    void hoverMoveEvent(QGraphicsSceneHoverEvent* event)    override;
    void hoverLeaveEvent(QGraphicsSceneHoverEvent* event)   override;
 
    bool eventFilter(QObject* watched, QEvent* event)       override;
 
private Q_SLOTS:
 
    void slotUpdate();
    void slotSizeChanged();
    void slotPosChanged();
    void hudSizeChanged();
    void moveHudWidget();
 
private:
 
    // Disable
    RegionFrameItem();
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
Q_DECLARE_OPERATORS_FOR_FLAGS(Digikam::RegionFrameItem::Flags)
 
#endif // DIGIKAM_REGION_FRAME_ITEM_H