/* This file is part of the KDE project SPDX-FileCopyrightText: 2002 Rob Buis (buis@kde.org) SPDX-FileCopyrightText: 2004 Nicolas GOUTTE SPDX-FileCopyrightText: 2007 Thomas Zander SPDX-License-Identifier: LGPL-2.0-or-later */ #ifndef KOUNITDOUBLESPINBOX_H #define KOUNITDOUBLESPINBOX_H #include "kowidgets_export.h" #include class KoUnit; /** * Spin box for double precision numbers with unit display. * Use this widget for any value that represents a real measurable value for consistency throughout * Calligra. * This widget shows the value in the user-selected units (inch, millimeters, etc) but keeps the * calligra-widget default measurement unit internally. This has the advantage that just setting and * getting a value will not change the value due to conversions. * The KoDocument class has a unit() method for consistent (document wide) configuration of the * used unit. * It is advised to use a QDoubleSpinBox in QtDesigner and then use the context-menu item: 'Promote to Custom Widget' and use the values: 'classname=KoUnitDoubleSpinBox', 'headerfile=KoUnitDoubleSpinBox.h' * This will generate code that uses this spinbox in the correct manner. */ class KOWIDGETS_EXPORT KoUnitDoubleSpinBox : public QDoubleSpinBox { Q_OBJECT public: /** * Constructor * Create a new spinBox with very broad range predefined. * This spinbox will have min and max borders of 10000 points and use * the default unit of points. * @param parent the parent widget */ explicit KoUnitDoubleSpinBox(QWidget *parent = nullptr); ~KoUnitDoubleSpinBox() override; /** * Set the new value in points which will then be converted to the current unit for display * @param newValue the new value * @see value() */ virtual void changeValue(double newValue); /** * This spinbox shows the internal value after a conversion to the unit set here. */ virtual void setUnit(const KoUnit &); /// @return the current value, converted in points double value() const; /// Set minimum value in points. void setMinimum(double min); /// Set maximum value in points. void setMaximum(double max); /// Set step size in the current unit. void setLineStep(double step); /// Set step size in points. void setLineStepPt(double step); /// Set minimum, maximum value and the step size (all in points) void setMinMaxStep(double min, double max, double step); /// reimplemented from superclass, will forward to KoUnitDoubleValidator QValidator::State validate(QString &input, int &pos) const override; /** * Transform the double in a nice text, using locale symbols * @param value the number as double * @return the resulting string */ QString textFromValue(double value) const override; /** * Transform a string into a double, while taking care of locale specific symbols. * @param str the string to transform into a number * @return the value as double */ double valueFromText(const QString& str) const override; Q_SIGNALS: /// emitted like valueChanged in the parent, but this one emits the point value void valueChangedPt(qreal); private: class Private; Private * const d; private Q_SLOTS: // exists to do emits for valueChangedPt void privateValueChanged(); }; #endif