The QtDoublePropertyManager provides and manages double properties. More...
#include <qtpropertymanager.h>
Public Slots | |
void | setDecimals (QtProperty *property, int prec) |
void | setMaximum (QtProperty *property, double maxVal) |
void | setMinimum (QtProperty *property, double minVal) |
void | setRange (QtProperty *property, double minVal, double maxVal) |
void | setReadOnly (QtProperty *property, bool readOnly) |
void | setSingleStep (QtProperty *property, double step) |
void | setValue (QtProperty *property, double val) |
Signals | |
void | decimalsChanged (QtProperty *property, int prec) |
void | rangeChanged (QtProperty *property, double minVal, double maxVal) |
void | readOnlyChanged (QtProperty *property, bool readOnly) |
void | singleStepChanged (QtProperty *property, double step) |
void | valueChanged (QtProperty *property, double val) |
Signals inherited from QtAbstractPropertyManager | |
void | propertyChanged (QtProperty *property) |
void | propertyDestroyed (QtProperty *property) |
void | propertyInserted (QtProperty *property, QtProperty *parent, QtProperty *after) |
void | propertyRemoved (QtProperty *property, QtProperty *parent) |
Public Member Functions | |
int | decimals (const QtProperty *property) const |
bool | isReadOnly (const QtProperty *property) const |
double | maximum (const QtProperty *property) const |
double | minimum (const QtProperty *property) const |
QtDoublePropertyManager (QObject *parent=nullptr) | |
double | singleStep (const QtProperty *property) const |
double | value (const QtProperty *property) const |
~QtDoublePropertyManager () override | |
Public Member Functions inherited from QtAbstractPropertyManager | |
QtProperty * | addProperty (const QString &name=QString()) |
void | clear () const |
QSet< QtProperty * > | properties () const |
QtAbstractPropertyManager (QObject *parent=nullptr) | |
~QtAbstractPropertyManager () override | |
Protected Member Functions | |
void | initializeProperty (QtProperty *property) override |
void | uninitializeProperty (QtProperty *property) override |
QString | valueText (const QtProperty *property) const override |
Protected Member Functions inherited from QtAbstractPropertyManager | |
virtual QtProperty * | createProperty () |
virtual QString | displayText (const QtProperty *property) const |
virtual EchoMode | echoMode (const QtProperty *) const |
virtual bool | hasValue (const QtProperty *property) const |
virtual QIcon | valueIcon (const QtProperty *property) const |
Private Attributes | |
QtDoublePropertyManagerPrivate * | d_ptr |
The QtDoublePropertyManager provides and manages double properties.
A double property has a current value, and a range specifying the valid values. The range is defined by a minimum and a maximum value.
The property's value and range can be retrieved using the value(), minimum() and maximum() functions, and can be set using the setValue(), setMinimum() and setMaximum() slots. Alternatively, the range can be defined in one go using the setRange() slot.
In addition, QtDoublePropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes, and the rangeChanged() signal which is emitted whenever such a property changes its range of valid values.
QtDoublePropertyManager::QtDoublePropertyManager | ( | QObject * | parent = nullptr | ) |
Creates a manager with the given parent.
References d_ptr, and QtDoublePropertyManagerPrivate::q_ptr.
|
override |
Destroys this manager, and all the properties it has created.
References QtAbstractPropertyManager::clear(), and d_ptr.
int QtDoublePropertyManager::decimals | ( | const QtProperty * | property | ) | const |
Returns the given property's precision, in decimals.
References d_ptr, QtDoublePropertyManagerPrivate::Data::decimals, and QtDoublePropertyManagerPrivate::m_values.
Referenced by QtDoubleSpinBoxFactory::createEditor().
|
signal |
This signal is emitted whenever a property created by this manager changes its precision of value, passing a pointer to the property and the new prec value
Referenced by setDecimals().
|
overrideprotectedvirtual |
\reimp
Implements QtAbstractPropertyManager.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by DecoratedDoublePropertyManager::initializeProperty().
bool QtDoublePropertyManager::isReadOnly | ( | const QtProperty * | property | ) | const |
Returns read-only status of the property.
When property is read-only it's value can be selected and copied from editor but not modified.
References d_ptr, QtDoublePropertyManagerPrivate::m_values, and QtDoublePropertyManagerPrivate::Data::readOnly.
double QtDoublePropertyManager::maximum | ( | const QtProperty * | property | ) | const |
Returns the given property's maximum value.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by QtDoubleSpinBoxFactory::createEditor().
double QtDoublePropertyManager::minimum | ( | const QtProperty * | property | ) | const |
Returns the given property's minimum value.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by QtDoubleSpinBoxFactory::createEditor().
|
signal |
This signal is emitted whenever a property created by this manager changes its range of valid values, passing a pointer to the property and the new minimum and maximum values
Referenced by setMaximum(), setMinimum(), and setRange().
|
signal |
|
slot |
Sets the precision of the given property to prec.
The valid decimal range is 0-13. The default is 2.
References d_ptr, QtDoublePropertyManagerPrivate::Data::decimals, decimalsChanged(), and QtDoublePropertyManagerPrivate::m_values.
Referenced by QtPointFPropertyManager::initializeProperty(), QtSizeFPropertyManager::initializeProperty(), QtRectFPropertyManager::initializeProperty(), QtVector3DPropertyManager::initializeProperty(), QtPointFPropertyManager::setDecimals(), QtSizeFPropertyManager::setDecimals(), QtRectFPropertyManager::setDecimals(), and QtVector3DPropertyManager::setDecimals().
|
slot |
Sets the maximum value for the given property to maxVal.
When setting the maximum value, the minimum and current values are adjusted if necessary (ensuring that the range remains valid and that the current value is within in the range).
References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().
|
slot |
Sets the minimum value for the given property to minVal.
When setting the minimum value, the maximum and current values are adjusted if necessary (ensuring that the range remains valid and that the current value is within in the range).
References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().
Referenced by QtSizeFPropertyManager::initializeProperty(), and QtRectFPropertyManager::initializeProperty().
|
slot |
Sets the range of valid values.
This is a convenience function defining the range of valid values in one go; setting the minimum and maximum values for the given property with a single function call.
When setting a new range, the current value is adjusted if necessary (ensuring that the value remains within range).
References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().
Referenced by MainWindow::itemClicked(), QtRectFPropertyManagerPrivate::setConstraint(), and QtSizeFPropertyManagerPrivate::setRange().
|
slot |
Sets read-only status of the property.
References d_ptr, QtDoublePropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtDoublePropertyManagerPrivate::Data::readOnly, and readOnlyChanged().
|
slot |
Sets the step value for the given property to step.
The step is typically used to increment or decrement a property value while pressing an arrow key.
References d_ptr, QtDoublePropertyManagerPrivate::m_values, QtDoublePropertyManagerPrivate::Data::singleStep, and singleStepChanged().
|
slot |
Sets the value of the given property to value.
If the specified value is not valid according to the given property's range, the value is adjusted to the nearest valid value within the range.
References d_ptr, QtAbstractPropertyManager::propertyChanged(), and valueChanged().
Referenced by QtPointFPropertyManager::initializeProperty(), QtSizeFPropertyManager::initializeProperty(), QtRectFPropertyManager::initializeProperty(), QtVector3DPropertyManager::initializeProperty(), MainWindow::itemClicked(), MainWindow::itemMoved(), main(), QtRectFPropertyManagerPrivate::setConstraint(), QtSizeFPropertyManagerPrivate::setRange(), QtPointFPropertyManager::setValue(), QtRectFPropertyManager::setValue(), QtVector3DPropertyManager::setValue(), QtSizeFPropertyManagerPrivate::setValue(), and QtDoubleSpinBoxFactoryPrivate::slotSetValue().
double QtDoublePropertyManager::singleStep | ( | const QtProperty * | property | ) | const |
Returns the given property's step value.
The step is typically used to increment or decrement a property value while pressing an arrow key.
References d_ptr, QtDoublePropertyManagerPrivate::m_values, and QtDoublePropertyManagerPrivate::Data::singleStep.
Referenced by QtDoubleSpinBoxFactory::createEditor().
|
signal |
This signal is emitted whenever a property created by this manager changes its single step property, passing a pointer to the property and the new step value
Referenced by setSingleStep().
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by DecoratedDoublePropertyManager::uninitializeProperty().
double QtDoublePropertyManager::value | ( | const QtProperty * | property | ) | const |
Returns the given property's value.
If the given property is not managed by this manager, this function returns 0.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by QtDoubleSpinBoxFactory::createEditor(), QtDoubleSpinBoxFactoryPrivate::slotDecimalsChanged(), and QtDoubleSpinBoxFactoryPrivate::slotRangeChanged().
|
signal |
This signal is emitted whenever a property created by this manager changes its value, passing a pointer to the property and the new value as parameters.
Referenced by setMaximum(), setMinimum(), setRange(), and setValue().
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References d_ptr, and QtDoublePropertyManagerPrivate::m_values.
Referenced by DecoratedDoublePropertyManager::valueText().
|
private |
Referenced by decimals(), initializeProperty(), isReadOnly(), maximum(), minimum(), QtDoublePropertyManager(), setDecimals(), setMaximum(), setMinimum(), setRange(), setReadOnly(), setSingleStep(), setValue(), singleStep(), uninitializeProperty(), value(), valueText(), and ~QtDoublePropertyManager().