TextButtonView.h

Go to the documentation of this file.

/*
 * Copyright (c) 2018-2019 pongasoft
 *
 * Licensed under the Apache License, Version 2.0 or the MIT license,
 * at your option. You may not use this file except in compliance with
 * one of these licenses. You may obtain copies of the licenses at:
 *
 * https://www.apache.org/licenses/LICENSE-2.0
 * https://opensource.org/licenses/MIT
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 *
 * @author Yan Pujante
 */
#pragma once
 
#include <vstgui4/vstgui/lib/controls/cbuttons.h>
#include <pongasoft/VST/GUI/Views/CustomView.h>
 
namespace pongasoft::VST::GUI::Views {
 
using namespace VSTGUI;
using namespace Params;

class TextButtonView : public CustomViewAdapter<CTextButton>
{
public:
  using OnClickListener = std::function<void()>;
 
  // Constructor
  explicit TextButtonView(const CRect &iSize) : CustomViewAdapter(iSize) {}

  virtual void setTitleTag(ParamID iValue);

  ParamID getTitleTag() const { return fTitleTag; };

  CColor const &getDisabledTextColor() const { return fDisabledTextColor; }

  virtual void setDisabledTextColor(CColor const &iColor) { fDisabledTextColor = iColor; };

  GradientPtr getDisabledGradient() const { return fDisabledGradient; }

  virtual void setDisabledGradient(GradientPtr iGradient) { fDisabledGradient = iGradient; };
 
  void setMouseEnabled(bool bEnable) override;
 
  // draw => overridden to handle disabled state
  void draw(CDrawContext *context) override;
 
  // registerParameters
  void registerParameters() override;
 
  // handles value change
  void valueChanged() override;
 
  // call to programmatically click the button
  virtual void click();
 
  // call to programmatically unClick the button
  virtual void unClick();
 
  // callback when the button is clicked
  virtual void onClick();
 
  // setOnClickListener
  void setOnClickListener(OnClickListener iListener) { fOnClickListener = std::move(iListener); }

  BitmapPtr getImage() const { return fImage; }
  void setImage(BitmapPtr iImage) { fImage = iImage; }

  bool getImageHasDisabledState() const { return fImageHasDisabledState; }
  void setImageHasDisabledState(bool iValue) { fImageHasDisabledState = iValue; }

  int32 getPrecisionOverride() const { return fPrecisionOverride; }
  void setPrecisionOverride(int32 iPrecisionOverride) { fPrecisionOverride = iPrecisionOverride; markDirty(); }
 
protected:
  virtual void drawButtonText(CDrawContext *context);

  virtual void drawButtonImage(CDrawContext *context);
 
protected:
  // (optionally) tie the title of this text button to a (Jmb) parameter
  ParamID fTitleTag{UNDEFINED_PARAM_ID};
 
  // Which color and gradient to use when disabled
  CColor fDisabledTextColor;
  GradientSPtr fDisabledGradient;
 
  // the underlying parameter => use its string representation to display the text of the button
  int32 fPrecisionOverride{-1};
 
  // the image to use (in place of text)
  BitmapSPtr fImage{nullptr};
 
  // whether the image has disabled state (3 frames) or not (2 frames)
  bool fImageHasDisabledState{false};
 
  // the onclick listener
  OnClickListener fOnClickListener{};
 
public:
  class Creator : public CustomViewCreator<TextButtonView, CustomViewAdapter<CTextButton>>
  {
  public:
    explicit Creator(char const *iViewName = nullptr, char const *iDisplayName = nullptr) :
      CustomViewCreator(iViewName, iDisplayName, VSTGUI::UIViewCreator::kCTextButton)
    {
      registerTagAttribute("title-tag", &TextButtonView::getTitleTag, &TextButtonView::setTitleTag);
      registerColorAttribute("disabled-text-color", &TextButtonView::getDisabledTextColor, &TextButtonView::setDisabledTextColor);
      registerGradientAttribute("disabled-gradient", &TextButtonView::getDisabledGradient, &TextButtonView::setDisabledGradient);
      registerBitmapAttribute("button-image", &TextButtonView::getImage, &TextButtonView::setImage);
      registerBooleanAttribute("button-image-has-disabled-state", &TextButtonView::getImageHasDisabledState, &TextButtonView::setImageHasDisabledState);
      registerIntegerAttribute<int32>("precision-override", &TextButtonView::getPrecisionOverride, &TextButtonView::setPrecisionOverride);
    }
  };
};
 
}