audacia/src/widgets/ASlider.h

367 lines
9.1 KiB
C++

/**********************************************************************
Audacity: A Digital Audio Editor
ASlider.h
Dominic Mazzoni
This class is a custom slider.
**********************************************************************/
#ifndef __AUDACITY_SLIDER__
#define __AUDACITY_SLIDER__
#include <wx/setup.h> // for wxUSE_* macros
#include <wx/defs.h>
#include <wx/timer.h> // member variable
#include "wxPanelWrapper.h" // to inherit
class wxBitmap;
class wxSize;
class wxPoint;
class wxTextCtrl;
class Ruler;
class TipWindow;
//
// Predefined slider types (mStyle)
//
#define FRAC_SLIDER 1 // 0.0...1.0
#define DB_SLIDER 2 // -36...36 dB
#define PAN_SLIDER 3 // -1.0...1.0
#define SPEED_SLIDER 4 // 0.01 ..3.0
#define VEL_SLIDER 5 // -50..50
#define DB_MIN -36.0f
#define DB_MAX 36.0f
#define FRAC_MIN 0.0f
#define FRAC_MAX 1.0f
#define SPEED_MIN 0.01f
#define SPEED_MAX 3.0f
#define VEL_MIN -50.0f
#define VEL_MAX 50.0f
// Customizable slider only: If stepValue is STEP_CONTINUOUS,
// every value on the slider between minValue and maxValue
// will be possible
//
#define STEP_CONTINUOUS 0.0f
//
// Lightweight slider - i.e. a slider that doesn't appear in
// its own window, but rather draws itself inside an existing
// window (used inside Track Labels). The ASlider class,
// which uses this class, is below.
//
class AUDACITY_DLL_API LWSlider
{
friend class ASlider;
friend class ASliderAx;
public:
// MM: Construct customizable slider
LWSlider(wxWindow * parent,
const TranslatableString &name,
const wxPoint &pos,
const wxSize &size,
float minValue,
float maxValue,
float stepValue,
bool canUseShift,
int style,
bool heavyweight=false,
bool popup=true,
int orientation = wxHORIZONTAL); // wxHORIZONTAL or wxVERTICAL. wxVERTICAL is currently only for DB_SLIDER.
// Construct predefined slider
LWSlider(wxWindow * parent,
const TranslatableString &name,
const wxPoint &pos,
const wxSize &size,
int style,
bool heavyweight=false,
bool popup=true,
int orientation = wxHORIZONTAL); // wxHORIZONTAL or wxVERTICAL. wxVERTICAL is currently only for DB_SLIDER.
void Init(wxWindow * parent,
const TranslatableString &name,
const wxPoint &pos,
const wxSize &size,
float minValue,
float maxValue,
float stepValue,
bool canUseShift,
int style,
bool heavyweight,
bool popup,
float speed,
int orientation = wxHORIZONTAL); // wxHORIZONTAL or wxVERTICAL. wxVERTICAL is currently only for DB_SLIDER.
virtual ~LWSlider();
wxWindowID GetId();
void SetId(wxWindowID id);
void SetDefaultValue(float value);
void SetDefaultShortcut(bool value);
void GetScroll(float & line, float & page);
void SetScroll(float line, float page);
void ShowTip(bool show);
void SetToolTipTemplate(const TranslatableString & tip);
float Get(bool convert = true);
void Set(float value);
void Increase(float steps);
void Decrease(float steps);
// If set to less than 1.0, moving the mouse one pixel will move
// the slider by less than 1 unit
void SetSpeed(float speed);
void Move(const wxPoint &newpos);
void AdjustSize(const wxSize & sz);
void OnPaint(wxDC &dc, bool highlighted);
void OnSize(wxSizeEvent & event);
void OnMouseEvent(wxMouseEvent & event);
void OnKeyDown(wxKeyEvent & event);
void Refresh();
void Redraw();
bool ShowDialog();
bool ShowDialog(wxPoint pos);
void SetEnabled(bool enabled);
bool GetEnabled() const;
float GetMinValue() const;
float GetMaxValue() const;
void SetParent(wxWindow *parent) { mParent = parent; }
void SendUpdate(float newValue);
private:
TranslatableString GetTip(float value) const;
TranslatableStrings GetWidestTips() const;
void FormatPopWin();
void SetPopWinPosition();
void CreatePopWin();
void DrawToBitmap(wxDC & dc);
bool DoShowDialog(wxPoint pos);
int ValueToPosition(float val);
float DragPositionToValue(int fromPos, bool shiftDown);
float ClickPositionToValue(int fromPos, bool shiftDown);
wxWindow *mParent;
int mStyle;
int mOrientation; // wxHORIZONTAL or wxVERTICAL. wxVERTICAL is currently only for DB_SLIDER.
bool mHW; // is it really heavyweight (in a window)
bool mPopup; // should display dialog on double click
int mLeft;
int mTop;
int mWidth; //In pixels
int mHeight; //In pixels
// for (mOrientation == wxHORIZONTAL)
int mCenterY;
int mLeftX;
int mRightX;
int mWidthX;
// for (mOrientation == wxVERTICAL) //v Vertical PAN_SLIDER currently not handled, forced to horizontal.
int mCenterX;
int mTopY;
int mBottomY; // low values at bottom
int mHeightY;
int mThumbWidth; //In pixels
int mThumbHeight; //In pixels
float mClickValue;
int mClickPos; // position in x if (mOrientation == wxHORIZONTAL), else in y
float mMinValue;
float mMaxValue;
float mStepValue;
float mSpeed;
float mScrollLine;
float mScrollPage;
float mCurrentValue;
bool mDefaultShortcut;
float mDefaultValue;
bool mCanUseShift;
wxWindowID mID;
std::unique_ptr<TipWindow> mTipPanel;
TranslatableString mTipTemplate;
bool mIsDragging;
std::unique_ptr<wxBitmap> mBitmap, mThumbBitmap, mThumbBitmapHilited;
TranslatableString mName;
bool mEnabled;
};
class AUDACITY_DLL_API ASlider /* not final */ : public wxPanel
{
friend class ASliderAx;
public:
struct Options {
Options() {}
int style{ FRAC_SLIDER };
wxOrientation orientation{ wxHORIZONTAL };
bool popup{ true };
bool canUseShift{ true };
float stepValue{ STEP_CONTINUOUS };
float line{ 1.0 };
float page{ 5.0 };
Options& Style( int s ) { style = s; return *this; }
Options& Orientation( wxOrientation o )
{ orientation = o; return *this; }
Options& Popup( bool p ) { popup = p; return *this; }
Options& CanUseShift( bool c ) { canUseShift = c; return *this; }
Options& StepValue( float v ) { stepValue = v; return *this; }
Options& Line( float l ) { line = l; return *this; }
Options& Page( float p ) { page = p; return *this; }
};
ASlider( wxWindow * parent,
wxWindowID id,
const TranslatableString &name,
const wxPoint & pos,
const wxSize & size,
const Options &options = Options{});
virtual ~ASlider();
bool AcceptsFocus() const override { return s_AcceptsFocus; }
bool AcceptsFocusFromKeyboard() const override { return true; }
void SetFocusFromKbd() override;
bool SetBackgroundColour(const wxColour& colour) override;
void GetScroll(float & line, float & page);
void SetScroll(float line, float page);
void SetToolTipTemplate(const TranslatableString & tip);
float Get( bool convert = true );
void Set(float value);
void Increase(float steps);
void Decrease(float steps);
bool ShowDialog(wxPoint pos = wxPoint(-1, -1));
void SetSpeed(float speed);
void OnErase(wxEraseEvent & event);
void OnPaint(wxPaintEvent & event);
void OnSize(wxSizeEvent & event);
void OnMouseEvent(wxMouseEvent & event);
void OnCaptureLost(wxMouseCaptureLostEvent & event);
void OnKeyDown(wxKeyEvent &event);
void OnSlider(wxCommandEvent &event);
void OnSetFocus(wxFocusEvent & event);
void OnKillFocus(wxFocusEvent & event);
void OnTimer(wxTimerEvent & event);
// Overrides of the wxWindow functions with the same semantics
bool Enable(bool enable = true) override;
bool IsEnabled() const;
private:
static bool s_AcceptsFocus;
struct Resetter { void operator () (bool *p) const { if(p) *p = false; } };
using TempAllowFocus = std::unique_ptr<bool, Resetter>;
public:
static TempAllowFocus TemporarilyAllowFocus();
private:
std::unique_ptr<LWSlider> mLWSlider;
bool mSliderIsFocused;
wxTimer mTimer;
protected:
int mStyle;
public:
DECLARE_EVENT_TABLE()
};
#define SLIDER_DIALOG_TEXTCTRL 100
// This is a modal dialog that contains an ASlider
// and a text-entry box which can be used to set the
// value of a slider.
class SliderDialog final : public wxDialogWrapper
{
public:
SliderDialog(wxWindow * parent, wxWindowID id,
const TranslatableString & title,
wxPoint position,
wxSize size,
int style,
float value,
float line,
float page,
LWSlider * pSlider=nullptr);
~SliderDialog();
float Get();
private:
bool TransferDataToWindow() override;
bool TransferDataFromWindow() override;
void OnSlider(wxCommandEvent &event);
void OnTextChange(wxCommandEvent &event);
ASlider * mSlider;
wxTextCtrl * mTextCtrl;
int mStyle;
LWSlider * mpOrigin;
float mValue;
public:
DECLARE_EVENT_TABLE()
};
#endif