GUIComponent.h

Go to the documentation of this file.

/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2013 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : ICLQt/src/ICLQt/GUIComponent.h                         **
** Module : ICLQt                                                  **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** GNU LESSER GENERAL PUBLIC LICENSE                               **
** This file may be used under the terms of the GNU Lesser General **
** Public License version 3.0 as published by the                  **
**                                                                 **
** Free Software Foundation and appearing in the file LICENSE.GPL  **
** included in the packaging of this file.  Please review the      **
** following information to ensure the license requirements will   **
** be met: http://www.gnu.org/licenses/lgpl-3.0.txt                **
**                                                                 **
** The development of this software was supported by the           **
** Excellence Cluster EXC 277 Cognitive Interaction Technology.    **
** The Excellence Cluster EXC 277 is a grant of the Deutsche       **
** Forschungsgemeinschaft (DFG) in the context of the German       **
** Excellence Initiative.                                          **
**                                                                 **
********************************************************************/

#pragma once

#include <ICLUtils/StringUtils.h>
#include <ICLUtils/Range.h>
#include <ICLUtils/Size.h>

namespace icl{
  namespace qt{
  

    class GUIComponent{
    
      friend class ContainerGUIComponent;
      
      friend class GUI;
  
      public:
      struct Options {
      Options():margin(-1),spacing(-1), hide(false){}
        std::string handle;  
        std::string out;     
        std::string in;      
        std::string label;   
        std::string tooltip; 
        int margin;          
        int spacing;         
        utils::Size minSize;        
        utils::Size maxSize;        
        utils::Size size;           
        bool hide;           
      };
      protected:
      
      mutable Options m_options;
      
      template<class A, class B, class C> 
      static std::string form_args_3(const A &a, const B &b, const C &c){
        std::ostringstream str;
        str << a << ',' << b << ',' << c;
        return str.str();
      }
      
      template<class A, class B, class C, class D> 
      static std::string form_args_4(const A &a, const B &b, const C &c, const D &d){
        std::ostringstream str;
        str << a << ',' << b << ',' << c << ',' << d;
        return str.str();
      }
      
      std::string m_type;
      
      std::string m_params;
      

      GUIComponent(const std::string &type, const std::string &params=""):
      m_type(type),m_params(params){}
      public:
        
      const GUIComponent &handle(const std::string &handle) const{
        m_options.handle = handle; return *this;
      }
  
      const GUIComponent &label(const std::string &label) const{
        m_options.label = label; return *this;
      }
  
      const GUIComponent &tooltip(const std::string &tooltip) const{
        m_options.tooltip = tooltip; return *this;
      }
  
      const GUIComponent &size(const utils::Size &size) const {
        m_options.size = size; return *this;
      }
  
      const GUIComponent &size(int w, int h) const {
        return size(utils::Size(w,h));
      }
  
      const GUIComponent &minSize(const utils::Size &minSize) const {
        m_options.minSize = minSize; return *this;
      }
        
      const GUIComponent &minSize(int w, int h) const {
        return minSize(utils::Size(w,h));
      }
      
      const GUIComponent &maxSize(const utils::Size &maxSize) const {
        m_options.maxSize = maxSize; return *this;
      }
  
      const GUIComponent &maxSize(int w, int h) const {
        return maxSize(utils::Size(w,h));
      }
  

      const GUIComponent &hideIf(bool flag) const{
        if(flag) m_options.hide = true; return *this;
      }
  
      GUIComponent &handle(std::string &handle) {
        m_options.handle = handle; return *this;
      }
      
      GUIComponent &label(std::string &label) {
        m_options.label = label; return *this;
      }
      
      GUIComponent &tooltip(std::string &tooltip) {
        m_options.tooltip = tooltip; return *this;
      }
      
      GUIComponent &size(utils::Size &size)  {
        m_options.size = size; return *this;
      }
      
      GUIComponent &size(int w, int h)  {
        m_options.size = utils::Size(w,h); return *this;
      }
      
      GUIComponent &minSize(utils::Size &minSize)  {
        m_options.minSize = minSize; return *this;
      }
  
      GUIComponent &minSize(int w, int h)  {
        m_options.minSize = utils::Size(w,h); return *this;
      }
      
      GUIComponent &maxSize(utils::Size &maxSize)  {
        m_options.maxSize = maxSize; return *this;
      }
      
      GUIComponent &maxSize(int w, int h)  {
        m_options.maxSize = utils::Size(w,h); return *this;
      }
  

      GUIComponent &hideIf(bool flag)  {
        if(flag) m_options.hide = true; return *this;
      }
      
      std::string toString() const {
        if(m_options.hide) return "";
        std::ostringstream str;
        str << m_type;
        if(m_params.length()){
          str << '(' << m_params << ')';
        }
        if(m_options.handle.length() ||
           m_options.label.length() ||
           m_options.out.length() ||
           m_options.in.length() ||
           m_options.tooltip.length() ||
           m_options.margin > 0 ||
           m_options.spacing > 0 ||
           m_options.minSize != utils::Size::null ||
           m_options.maxSize != utils::Size::null ||
           m_options.size != utils::Size::null ){
          str << '[';
          if(m_options.handle.length()) str << "@handle=" << m_options.handle;
          if(m_options.out.length()) str << "@out=" << m_options.out;
          if(m_options.in.length()) str << "@in=" << m_options.in;
          if(m_options.label.length()) str << "@label=" << m_options.label;
          if(m_options.tooltip.length()) str << "@tooltip=" << m_options.tooltip;
          if(m_options.margin > 0) str << "@margin=" << m_options.margin;
          if(m_options.spacing > 0) str << "@spacing=" << m_options.spacing;
          if(m_options.minSize != utils::Size::null ) str << "@minsize=" << m_options.minSize;
          if(m_options.maxSize != utils::Size::null ) str << "@maxsize=" << m_options.maxSize;
          if(m_options.size != utils::Size::null ) str << "@size=" << m_options.size;
          str << "]";
        }
        return str.str();
      }
    };
  } // namespace qt
}