Mercurial > hg > orthanc-stone
view OrthancStone/Sources/Scene2DViewport/IFlexiblePointerTracker.h @ 2016:f30d7055ed6a
new URL argument "menu" to change the layout of the list of studies/series
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Sat, 03 Dec 2022 08:12:14 +0100 |
parents | 5a434f5889f8 |
children | 07964689cb0b |
line wrap: on
line source
/** * Stone of Orthanc * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics * Department, University Hospital of Liege, Belgium * Copyright (C) 2017-2022 Osimis S.A., Belgium * Copyright (C) 2021-2022 Sebastien Jodogne, ICTEAM UCLouvain, Belgium * * This program is free software: you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public License * as published by the Free Software Foundation, either version 3 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this program. If not, see * <http://www.gnu.org/licenses/>. **/ #pragma once #include "PredeclaredTypes.h" #include "../Scene2D/PointerEvent.h" namespace OrthancStone { /** This interface represents a flexible mouse tracker that can respond to several events and is not automatically deleted upon mouse up or when touch interaction is suspended : for instance, a stateful tracker with a two-step interaction like: click & drag --> mouse up --> drag --> mouse click (for instance, for an angle measuring tracker or an ellipse tracker) */ class IFlexiblePointerTracker : public boost::noncopyable { public: virtual ~IFlexiblePointerTracker() {} /** This method will be repeatedly called during user interaction */ virtual void PointerMove(const PointerEvent& event, const Scene2D& scene) = 0; /** This method will be called when a touch/pointer is removed (mouse up, pen lift, finger removed...) */ virtual void PointerUp(const PointerEvent& event, const Scene2D& scene) = 0; /** This method will be called when a touch/pointer is added (mouse down, pen or finger press) Important note: the initial pointer down that leads to creating the tracker is NOT sent to the tracker. Thus, if you count the PointerDown vs PointerUp, there will be an extra PointerUp. */ virtual void PointerDown(const PointerEvent& event, const Scene2D& scene) = 0; /** This method will be repeatedly called by the tracker owner (for instance, the application) to check whether the tracker must keep on receiving interaction or if its job is done and it should be deleted. */ virtual bool IsAlive() const = 0; /** This will be called if the tracker needs to be dismissed without committing its changes to the underlying model. If the model has been modified during tracker lifetime, it must be restored to its initial value */ virtual void Cancel(const Scene2D& scene) = 0; }; }