File indexing completed on 2024-05-19 04:36:35

 /* This file is part of the TikZKit project.
  *
  * Copyright (C) 2013-2014 Dominik Haumann <dhaumann@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, see
  * <http://www.gnu.org/licenses/>.
  */
 
 #ifndef TIKZ_UI_PATH_HANDLE_H
 #define TIKZ_UI_PATH_HANDLE_H
 
 #include <tikz/core/tikz.h>
 
 #include "TikzItem.h"
 
 class QPainter;
 class QGraphicsView;
 
 namespace tikz {
 namespace ui {
 
 class Handle : public TikzItem
 {
     Q_OBJECT
 
     public:
         enum Position {
             TopLeftCorner = 0,
             TopRightCorner,
             BottomLeftCorner,
             BottomRightCorner,
 
             LeftBorder,
             TopBorder,
             RightBorder,
             BottomBorder,
 
             ResizePos,
 
             Center,
 
             // used for lines
             StartPos,
             EndPos,
 
             UserPos
         };
 
         enum Type {
             MoveHandle,
             ResizeHandle,
             RotateHandle,
             AnchorHandle
         };
 
     public:
         /**
          * Constructor.
          */
         Handle(Type type = ResizeHandle, Position position = Position::UserPos);
 
         /**
          * Destructor
          */
         virtual ~Handle();
 
         /**
          * Reimplment to return a proper UserType + 5.
          */
         int type() const override;
 
         /**
          * Get the handle position.
          */
         Position handlePos() const;
 
         /**
          * Get the handle type.
          */
         Type handleType() const;
 
     //
     // geometry
     //
     public:
         /**
          * Returns the rect in local coordinates
          */
         QRectF rect() const;
 
     public Q_SLOTS:
         /**
          * Sets this Handle's rect to @p rect
          */
         void setRect(const QRectF & rect);
 
     //
     // active flag
     //
     public:
         /**
          * Check whether the handle is set active or not.
          *
          * The handle is active either when the mouse is pressed, or if you
          * manually call activate().
          *
          * Depending on isActive(), handles can change the appearance.
          *
          * @see activate(), deactivate()
          */
         bool isActive() const;
 
     public Q_SLOTS:
         /**
          * Activates this item.
          *
          * @see isActive()
          */
         void activate();
 
         /**
          * Deactivates this item.
          *
          * @see isActive()
          */
         void deactivate();
 
     Q_SIGNALS:
         /**
          * This signal is emitted whenever the position of this handle
          * changed through user interaction.
          * @param handle the handle object that sent this signal
          * @param pos position in scene coordinates
          * @param view the view the user interacted with
          */
         void positionChanged(tikz::ui::Handle * handle, const QPointF & pos, QGraphicsView * view);
 
         /**
          * This signal is emitted whenever the mouse is pressed on the handle.
          * @param handle the handle object that sent this signal
          * @param pos position in scene coordinates
          * @param view the view the user interacted with
          */
         void mousePressed(tikz::ui::Handle * handle, const QPointF & pos, QGraphicsView * view);
 
         /**
          * This signal is emitted whenever the mouse is released on the handle.
          * @param handle the handle object that sent this signal
          * @param pos position in scene coordinates
          * @param view the view the user interacted with
          */
         void mouseReleased(tikz::ui::Handle * handle, const QPointF & pos, QGraphicsView * view);
 
     //
     // reimplemented from QGraphicsItem
     //
     public:
         /**
          * Paint this item.
          */
         void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;
 
         /**
          * Returns the bounding rect of this item.
          */
         QRectF boundingRect() const override;
 
     //
     // protected overrides
     //
     protected:
         /**
          * Reimplement to emit signal mousePressed()
          */
         void mouseMoveEvent(QGraphicsSceneMouseEvent * event) override;
 
         /**
          * Reimplement to emit signal positionChanged()
          */
         void mousePressEvent(QGraphicsSceneMouseEvent * event) override;
 
         /**
          * Reimplement to emit signal mouseReleased()
          */
         void mouseReleaseEvent(QGraphicsSceneMouseEvent * event) override;
 
     //
     // private data
     //
     private:
         Type m_type;
         Position m_position;
         QRectF m_handleRect;
         bool m_active = false;
 };
 
 }
 }
 
 #endif // TIKZ_UI_PATH_HANDLE_H
 
 // kate: indent-width 4; replace-tabs on;