A widget for qreal values with a popup slider. More...

#include <KoSliderCombo.h>

Inheritance diagram for KoSliderCombo:

Public Slots
void	setValue (qreal value)

Signals
void	valueChanged (qreal value, bool final)

Public Member Functions
qreal	decimals () const

void	hidePopup ()

	KoSliderCombo (QWidget *parent=0)

void	lineEditFinished ()

qreal	maximum () const

qreal	minimum () const

QSize	minimumSizeHint () const override
	reimplemented from QComboBox

void	setDecimals (int number)

void	setMaximum (qreal max)

void	setMinimum (qreal min)

void	showPopup ()

QSize	sizeHint () const override
	reimplemented from QComboBox

void	sliderReleased ()

void	sliderValueChanged (int value)

qreal	value () const

	~KoSliderCombo () override

Public Attributes
QStyle::StateFlag	arrowState

KoSliderComboContainer *	container

int	decimals

bool	firstShowOfSlider

QTimer	m_timer

QValidator *	m_validator

qreal	maximum

qreal	minimum

QSlider *	slider

KoSliderCombo *	thePublic

Protected Member Functions
void	changeEvent (QEvent *e) override
	reimplemented from QComboBox

void	hideEvent (QHideEvent *) override
	reimplemented from QComboBox

void	keyPressEvent (QKeyEvent *e) override
	reimplemented from QComboBox

void	mousePressEvent (QMouseEvent *e) override
	reimplemented from QComboBox

void	paintEvent (QPaintEvent *) override
	reimplemented from QComboBox

void	wheelEvent (QWheelEvent *e) override
	reimplemented from QComboBox

Private Attributes
KoSliderComboPrivate *const	d

Detailed Description

A widget for qreal values with a popup slider.

KoSliderCombo combines a numerical input and a dropdown slider in a way that takes up as little screen space as possible.

It allows the user to either enter a floating point value or quickly set the value using a slider

One signal is emitted when the value changes. The signal is even emitted when the slider is moving. The second argument of the signal however tells you if the value is final or not. A final value is produced by entering a value numerically or by releasing the slider.

The input of the numerical line edit is constrained to numbers and decimal signs.

Definition at line 28 of file KoSliderCombo.h.

Constructor & Destructor Documentation

◆ KoSliderCombo()

KoSliderCombo::KoSliderCombo ( QWidget * parent = 0 )

explicit

Constructor for the widget, where value is set to 0

Parameters

parent parent QWidget

Definition at line 26 of file KoSliderCombo.cpp.

   : QComboBox(parent)
    ,d(new KoSliderComboPrivate())
{
    d->thePublic = this;
    d->minimum = 0.0;
    d->maximum = 100.0;
    d->decimals = 2;
    d->container = new KoSliderComboContainer(this);
    d->container->setAttribute(Qt::WA_WindowPropagation);
    QStyleOptionComboBox opt;
    opt.initFrom(this);
//    d->container->setFrameStyle(style()->styleHint(QStyle::SH_ComboBox_PopupFrameStyle, &opt, this));
 
    d->slider = new QSlider(Qt::Horizontal);
    d->slider->setMinimum(0);
    d->slider->setMaximum(256);
    d->slider->setPageStep(10);
    d->slider->setValue(0);
    // When set to true, causes flicker on Qt 4.6. Any reason to keep it?
    d->firstShowOfSlider = false; //true;
 
    QHBoxLayout *layout = new QHBoxLayout(d->container);
    layout->setContentsMargins(2, 2, 2, 2);
    layout->setSpacing(2);
    layout->addWidget(d->slider);
    d->container->resize(200, 30);
 
    setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Fixed);
 
    setEditable(true);
    setEditText(QLocale().toString(0.0, d->decimals));
 
    connect(d->slider, SIGNAL(valueChanged(int)), SLOT(sliderValueChanged(int)));
    connect(d->slider, SIGNAL(sliderReleased()), SLOT(sliderReleased()));
    connect(lineEdit(), SIGNAL(editingFinished()), SLOT(lineEditFinished()));
}

References connect(), d, lineEditFinished(), sliderReleased(), sliderValueChanged(), and valueChanged().

◆ ~KoSliderCombo()

KoSliderCombo::~KoSliderCombo ( )

override

Destructor

Definition at line 64 of file KoSliderCombo.cpp.

{
    delete d;
}

References d.

Member Function Documentation

◆ changeEvent()

void KoSliderCombo::changeEvent ( QEvent * e )

overrideprotected

reimplemented from QComboBox

Definition at line 140 of file KoSliderCombo.cpp.

{
    switch (e->type())
    {
        case QEvent::EnabledChange:
            if (!isEnabled())
                d->hidePopup();
            break;
        case QEvent::PaletteChange:
            d->container->setPalette(palette());
            break;
        default:
            break;
    }
    QComboBox::changeEvent(e);
}

References d, and palette.

◆ decimals()

qreal KoSliderCombo::decimals ( ) const

The precision of values given as the number of digits after the period. default is 2

◆ hideEvent()

void KoSliderCombo::hideEvent ( QHideEvent * )

overrideprotected

reimplemented from QComboBox

Definition at line 135 of file KoSliderCombo.cpp.

{
    d->hidePopup();
}

References d.

◆ hidePopup()

void KoSliderCombo::hidePopup ( )

◆ keyPressEvent()

void KoSliderCombo::keyPressEvent ( QKeyEvent * e )

overrideprotected

reimplemented from QComboBox

Definition at line 187 of file KoSliderCombo.cpp.

{
    if (e->key() == Qt::Key_Up) setValue(value() + d->slider->singleStep() * (maximum() - minimum()) / 256 + 0.5);
    else if (e->key() == Qt::Key_Down) setValue(value() - d->slider->singleStep() * (maximum() - minimum()) / 256 - 0.5);
    else QComboBox::keyPressEvent(e);
}

References d, maximum, minimum, setValue(), and value().

◆ lineEditFinished()

void KoSliderCombo::lineEditFinished ( )

◆ maximum()

qreal KoSliderCombo::maximum ( ) const

The maximum value that can be entered. default is 100

◆ minimum()

qreal KoSliderCombo::minimum ( ) const

The minimum value that can be entered. default is 0

◆ minimumSizeHint()

QSize KoSliderCombo::minimumSizeHint ( ) const

override

reimplemented from QComboBox

Definition at line 74 of file KoSliderCombo.cpp.

{
    QSize sh;
 
    const QFontMetrics &fm = fontMetrics();
    sh.setWidth(5 * fm.horizontalAdvance(QLatin1Char('8')));
    sh.setHeight(qMax(fm.lineSpacing(), 14) + 2);
 
    // add style and strut values
    QStyleOptionComboBox opt;
    opt.initFrom(this);
    opt.subControls = QStyle::SC_All;
    opt.editable = true;
    sh = style()->sizeFromContents(QStyle::CT_ComboBox, &opt, sh, this);
 
    return sh;
}

◆ mousePressEvent()

void KoSliderCombo::mousePressEvent ( QMouseEvent * e )

overrideprotected

reimplemented from QComboBox

Definition at line 171 of file KoSliderCombo.cpp.

{
    QStyleOptionComboBox opt;
    opt.initFrom(this);
    opt.subControls = QStyle::SC_All;
    opt.editable = true;
    QStyle::SubControl sc = style()->hitTestComplexControl(QStyle::CC_ComboBox, &opt, e->pos(),
                                                           this);
    if (sc == QStyle::SC_ComboBoxArrow && !d->container->isVisible())
    {
        d->showPopup();
    }
    else
        QComboBox::mousePressEvent(e);
}

References d.

◆ paintEvent()

void KoSliderCombo::paintEvent ( QPaintEvent * )

overrideprotected

reimplemented from QComboBox

Definition at line 157 of file KoSliderCombo.cpp.

{
    QStylePainter gc(this);
 
    gc.setPen(palette().color(QPalette::Text));
 
    QStyleOptionComboBox opt;
    opt.initFrom(this);
    opt.subControls = QStyle::SC_All;
    opt.editable = true;
    gc.drawComplexControl(QStyle::CC_ComboBox, opt);
    gc.drawControl(QStyle::CE_ComboBoxLabel, opt);
}

References palette.

◆ setDecimals()

void KoSliderCombo::setDecimals ( int number )

Sets the precision of the entered values.

Parameters

number the number of digits after the period

Definition at line 243 of file KoSliderCombo.cpp.

{
    d->decimals = dec;
    if (dec == 0) lineEdit()->setValidator(new QIntValidator(this));
    else lineEdit()->setValidator(new QDoubleValidator(this));
}

References d.

◆ setMaximum()

void KoSliderCombo::setMaximum ( qreal max )

Sets the maximum value that can be entered.

Parameters

max	the maximum value

Definition at line 255 of file KoSliderCombo.cpp.

{
    d->maximum = max;
}

References d.

◆ setMinimum()

void KoSliderCombo::setMinimum ( qreal min )

Sets the minimum value that can be entered.

Parameters

min	the minimum value

Definition at line 250 of file KoSliderCombo.cpp.

{
    d->minimum = min;
}

References d.

◆ setValue

void KoSliderCombo::setValue ( qreal value )

slot

Sets the value. The value actually set is forced to be within the legal range: minimum <= value <= maximum

Parameters

value the new value

Definition at line 260 of file KoSliderCombo.cpp.

{
    if(value < d->minimum)
        value = d->minimum;
    if(value > d->maximum)
        value = d->maximum;
    setEditText(QLocale().toString(value, d->decimals));
    d->slider->blockSignals(true);
    d->slider->setValue(int((value - d->minimum) * 256 / (d->maximum - d->minimum) + 0.5));
    d->slider->blockSignals(false);
    Q_EMIT valueChanged(value, true);
}

References d, minimum, value(), and valueChanged().

◆ showPopup()

void KoSliderCombo::showPopup ( )

◆ sizeHint()

QSize KoSliderCombo::sizeHint ( ) const

override

reimplemented from QComboBox

Definition at line 69 of file KoSliderCombo.cpp.

{
    return minimumSizeHint();
}

References minimumSizeHint().

◆ sliderReleased()

void KoSliderCombo::sliderReleased ( )

◆ sliderValueChanged()

void KoSliderCombo::sliderValueChanged ( int value )

◆ value()

qreal KoSliderCombo::value ( ) const

The value shown.

Definition at line 238 of file KoSliderCombo.cpp.

{
    return QLocale().toDouble(currentText());
}

◆ valueChanged

void KoSliderCombo::valueChanged	(	qreal	value,
		bool	final )

signal

Emitted every time the value changes (by calling setValue() or by user interaction).

Parameters

value	the new value
final	if the value is final ie not produced during sliding (on slider release it's final)

◆ wheelEvent()

void KoSliderCombo::wheelEvent ( QWheelEvent * e )

overrideprotected

reimplemented from QComboBox

Definition at line 194 of file KoSliderCombo.cpp.

{
    if (e->angleDelta().y() > 0) setValue(value() + d->slider->singleStep() * (maximum() - minimum()) / 256 + 0.5);
    else setValue(value() - d->slider->singleStep() * (maximum() - minimum()) / 256 - 0.5);
}

References d, maximum, minimum, setValue(), and value().

Member Data Documentation

◆ arrowState

QStyle::StateFlag KoSliderCombo::arrowState

Definition at line 60 of file KoSliderCombo_p.h.

◆ container

KoSliderComboContainer* KoSliderCombo::container

Definition at line 58 of file KoSliderCombo_p.h.

◆ d

KoSliderComboPrivate* const KoSliderCombo::d

private

Definition at line 125 of file KoSliderCombo.h.

◆ decimals

qreal KoSliderCombo::decimals

Definition at line 63 of file KoSliderCombo_p.h.

◆ firstShowOfSlider

bool KoSliderCombo::firstShowOfSlider

Definition at line 64 of file KoSliderCombo_p.h.

◆ m_timer

QTimer KoSliderCombo::m_timer

Definition at line 57 of file KoSliderCombo_p.h.

◆ m_validator

QValidator* KoSliderCombo::m_validator

Definition at line 56 of file KoSliderCombo_p.h.

◆ maximum

qreal KoSliderCombo::maximum

Definition at line 62 of file KoSliderCombo_p.h.

◆ minimum

qreal KoSliderCombo::minimum

Definition at line 61 of file KoSliderCombo_p.h.

◆ slider

QSlider* KoSliderCombo::slider

Definition at line 59 of file KoSliderCombo_p.h.

◆ thePublic

KoSliderCombo* KoSliderCombo::thePublic

Definition at line 55 of file KoSliderCombo_p.h.

The documentation for this class was generated from the following files:

libs/widgets/KoSliderCombo.h
libs/widgets/KoSliderCombo_p.h
libs/widgets/KoSliderCombo.cpp

Public Slots

Signals

Public Member Functions

Public Attributes

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ KoSliderCombo()

◆ ~KoSliderCombo()

Member Function Documentation

◆ changeEvent()

◆ decimals()

◆ hideEvent()

◆ hidePopup()

◆ keyPressEvent()

◆ lineEditFinished()

◆ maximum()

◆ minimum()

◆ minimumSizeHint()

◆ mousePressEvent()

◆ paintEvent()

◆ setDecimals()

◆ setMaximum()

◆ setMinimum()

◆ setValue

◆ showPopup()

◆ sizeHint()

◆ sliderReleased()

◆ sliderValueChanged()

◆ value()

◆ valueChanged

◆ wheelEvent()

Member Data Documentation

◆ arrowState

◆ container

◆ d

◆ decimals

◆ firstShowOfSlider

◆ m_timer

◆ m_validator

◆ maximum

◆ minimum

◆ slider

◆ thePublic