The QtSizeFPropertyManager provides and manages QSizeF properties. More...
#include <qtpropertymanager.h>
Public Slots | |
void | setDecimals (QtProperty *property, int prec) |
void | setMaximum (QtProperty *property, const QSizeF &maxVal) |
void | setMinimum (QtProperty *property, const QSizeF &minVal) |
void | setRange (QtProperty *property, const QSizeF &minVal, const QSizeF &maxVal) |
void | setValue (QtProperty *property, const QSizeF &val) |
Signals | |
void | decimalsChanged (QtProperty *property, int prec) |
void | rangeChanged (QtProperty *property, const QSizeF &minVal, const QSizeF &maxVal) |
void | valueChanged (QtProperty *property, const QSizeF &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 |
QSizeF | maximum (const QtProperty *property) const |
QSizeF | minimum (const QtProperty *property) const |
QtSizeFPropertyManager (QObject *parent=nullptr) | |
QtDoublePropertyManager * | subDoublePropertyManager () const |
QSizeF | value (const QtProperty *property) const |
~QtSizeFPropertyManager () 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 |
The QtSizeFPropertyManager provides and manages QSizeF properties.
A size property has nested width and height subproperties. The top-level property's value can be retrieved using the value() function, and set using the setValue() slot.
The subproperties are created by a QtDoublePropertyManager object. This manager can be retrieved using the subDoublePropertyManager() function. In order to provide editing widgets for the subproperties in a property browser widget, this manager must be associated with an editor factory.
A size property also has a range of valid values defined by a minimum size and a maximum size. These sizes can be retrieved using the minimum() and the maximum() functions, and set using the setMinimum() and setMaximum() slots. Alternatively, the range can be defined in one go using the setRange() slot.
In addition, QtSizeFPropertyManager 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 sizes.
QtSizeFPropertyManager::QtSizeFPropertyManager | ( | QObject * | parent = nullptr | ) |
Creates a manager with the given parent.
References QtSizeFPropertyManagerPrivate::m_doublePropertyManager, QtAbstractPropertyManager::propertyDestroyed(), and valueChanged().
|
override |
Destroys this manager, and all the properties it has created.
References QtAbstractPropertyManager::clear().
int QtSizeFPropertyManager::decimals | ( | const QtProperty * | property | ) | const |
Returns the given property's precision, in decimals.
References QtSizeFPropertyManagerPrivate::Data::decimals, and QtSizeFPropertyManagerPrivate::m_values.
Referenced by initializeProperty().
|
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 QtAbstractPropertyManager::addProperty(), QtProperty::addSubProperty(), decimals(), QtSizeFPropertyManagerPrivate::m_doublePropertyManager, QtSizeFPropertyManagerPrivate::m_hToProperty, QtSizeFPropertyManagerPrivate::m_propertyToH, QtSizeFPropertyManagerPrivate::m_propertyToW, QtSizeFPropertyManagerPrivate::m_values, QtSizeFPropertyManagerPrivate::m_wToProperty, QtDoublePropertyManager::setDecimals(), QtDoublePropertyManager::setMinimum(), QtProperty::setPropertyName(), and QtDoublePropertyManager::setValue().
QSizeF QtSizeFPropertyManager::maximum | ( | const QtProperty * | property | ) | const |
Returns the given property's maximum size value.
References QtSizeFPropertyManagerPrivate::m_values.
QSizeF QtSizeFPropertyManager::minimum | ( | const QtProperty * | property | ) | const |
Returns the given property's minimum size value.
References QtSizeFPropertyManagerPrivate::m_values.
|
signal |
This signal is emitted whenever a property created by this manager changes its range of valid sizes, passing a pointer to the property and the new minimum and maximum sizes.
Referenced by setMaximum(), setMinimum(), and setRange().
|
slot |
Sets the precision of the given property to prec.
The valid decimal range is 0-13. The default is 2.
References QtSizeFPropertyManagerPrivate::Data::decimals, decimalsChanged(), QtSizeFPropertyManagerPrivate::m_doublePropertyManager, QtSizeFPropertyManagerPrivate::m_propertyToH, QtSizeFPropertyManagerPrivate::m_propertyToW, QtSizeFPropertyManagerPrivate::m_values, and QtDoublePropertyManager::setDecimals().
|
slot |
Sets the maximum size value for the given property to maxVal.
When setting the maximum size value, the minimum and current values are adjusted if necessary (ensuring that the size range remains valid and that the current value is within the range).
References QtSizeFPropertyManagerPrivate::Data::maximumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::Data::setMaximumValue(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().
|
slot |
Sets the minimum size value for the given property to minVal.
When setting the minimum size value, the maximum and current values are adjusted if necessary (ensuring that the size range remains valid and that the current value is within the range).
References QtSizeFPropertyManagerPrivate::Data::minimumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::Data::setMinimumValue(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().
|
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 the range).
References QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().
|
slot |
Sets the value of the given property to value.
If the specified value is not valid according to the given property's size range, the value is adjusted to the nearest valid value within the size range.
References QtAbstractPropertyManager::propertyChanged(), QtSizeFPropertyManagerPrivate::setValue(), and valueChanged().
Referenced by QtSizeFPropertyManagerPrivate::slotDoubleChanged().
QtDoublePropertyManager * QtSizeFPropertyManager::subDoublePropertyManager | ( | ) | const |
Returns the manager that creates the nested width and height subproperties.
In order to provide editing widgets for the width and height properties in a property browser widget, this manager must be associated with an editor factory.
References QtSizeFPropertyManagerPrivate::m_doublePropertyManager.
|
overrideprotectedvirtual |
QSizeF QtSizeFPropertyManager::value | ( | const QtProperty * | property | ) | const |
Returns the given property's value.
If the given property is not managed by this manager, this function returns an invalid size
References QtSizeFPropertyManagerPrivate::m_values.
|
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 QtSizeFPropertyManager(), setMaximum(), setMinimum(), setRange(), and setValue().
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References QtSizeFPropertyManagerPrivate::m_values.