expander-revealer.hpp

Go to the documentation of this file.

/*
  EXPANDER-REVEALER.hpp  -  functor components for standard UI element actions

   Copyright (C)
     2018,            Hermann Vosseler <Ichthyostega@web.de>

  **Lumiera** 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. See the file COPYING for further details.

*/


#ifndef STAGE_MODEL_EXPANDER_REVEALER_H
#define STAGE_MODEL_EXPANDER_REVEALER_H


#include "lib/error.hpp"

#include <functional>
#include <utility>


namespace stage {
namespace model {

  using std::move;
  
  
  class Expander
    {
    public:
      using ProbeFun = std::function<bool(void)>;
      using ChangeFun = std::function<void(bool)>;
      
    private:
      ProbeFun probeState_;
      ChangeFun changeState_;
      
    public:
      Expander() { }
      Expander(ProbeFun detectCurrExpansionState, ChangeFun expand_collapse)
        : probeState_{move (detectCurrExpansionState)}
        , changeState_{move (expand_collapse)}
        {
          ENSURE (canExpand());
        }
      
      bool
      canExpand()  const
        {
          return bool{probeState_}
             and bool{changeState_};
        }
      
      explicit
      operator bool()  const
        {
          REQUIRE (canExpand());
          return probeState_();
        }
      
      bool
      operator() (bool shallExpand)
        {
          REQUIRE (canExpand());
          bool currState = probeState_();
          if (currState != shallExpand)
            changeState_(shallExpand);
          return currState;
        }
      
      /* === alternate "expressive" API === */
      bool
      expand (bool yes =true)
        {
          return this->operator() (yes);
        }
      
      bool
      collapse()
        {
          return expand (false);
        }
      
      bool
      isExpanded()  const
        {
          return bool{*this};
        }
    };
  
  
  
  class Revealer
    {
    public:
      using RevealeItFun = std::function<void()>;
      
    private:
      RevealeItFun revealIt_;
      
    public:
      Revealer() { }
      Revealer(RevealeItFun how_to_uncover_the_element)
        : revealIt_{move (how_to_uncover_the_element)}
        {
          ENSURE (canReveal());
        }
      
      bool
      canReveal()  const
        {
          return bool{revealIt_};
        }
      
      void
      operator()()
        {
          REQUIRE (canReveal());
          revealIt_();
        }
    };
  
  
  
}} // namespace stage::model
#endif /*STAGE_MODEL_EXPANDER_REVEALER_H*/