The QtRectFPropertyManager provides and manages QRectF properties. More...
#include <qtpropertymanager.h>
Public Slots | |
void | setConstraint (QtProperty *property, const QRectF &constraint) |
void | setDecimals (QtProperty *property, int prec) |
void | setValue (QtProperty *property, const QRectF &val) |
Signals | |
void | constraintChanged (QtProperty *property, const QRectF &constraint) |
void | decimalsChanged (QtProperty *property, int prec) |
void | valueChanged (QtProperty *property, const QRectF &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 | |
QRectF | constraint (const QtProperty *property) const |
int | decimals (const QtProperty *property) const |
QtRectFPropertyManager (QObject *parent=nullptr) | |
QtDoublePropertyManager * | subDoublePropertyManager () const |
QRectF | value (const QtProperty *property) const |
~QtRectFPropertyManager () 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 QtRectFPropertyManager provides and manages QRectF properties.
A rectangle property has nested x, y, 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 rectangle property also has a constraint rectangle which can be retrieved using the constraint() function, and set using the setConstraint() slot.
In addition, QtRectFPropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes, and the constraintChanged() signal which is emitted whenever such a property changes its constraint rectangle.
QtRectFPropertyManager::QtRectFPropertyManager | ( | QObject * | parent = nullptr | ) |
Creates a manager with the given parent.
References QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtAbstractPropertyManager::propertyDestroyed(), and valueChanged().
|
override |
Destroys this manager, and all the properties it has created.
References QtAbstractPropertyManager::clear().
QRectF QtRectFPropertyManager::constraint | ( | const QtProperty * | property | ) | const |
Returns the given property's constraining rectangle. If returned value is null QRectF it means there is no constraint applied.
References QtRectFPropertyManagerPrivate::Data::constraint, and QtRectFPropertyManagerPrivate::m_values.
Referenced by setConstraint().
|
signal |
This signal is emitted whenever property changes its constraint rectangle, passing a pointer to the property and the new constraint rectangle as parameters.
Referenced by setConstraint().
int QtRectFPropertyManager::decimals | ( | const QtProperty * | property | ) | const |
Returns the given property's precision, in decimals.
References QtRectFPropertyManagerPrivate::Data::decimals, and QtRectFPropertyManagerPrivate::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(), QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_hToProperty, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtRectFPropertyManagerPrivate::m_wToProperty, QtRectFPropertyManagerPrivate::m_xToProperty, QtRectFPropertyManagerPrivate::m_yToProperty, QtDoublePropertyManager::setDecimals(), QtDoublePropertyManager::setMinimum(), QtProperty::setPropertyName(), and QtDoublePropertyManager::setValue().
|
slot |
Sets the given property's constraining rectangle to constraint.
When setting the constraint, the current value is adjusted if necessary (ensuring that the current rectangle value is inside the constraint). In order to reset the constraint pass a null QRectF value.
References QtRectFPropertyManagerPrivate::Data::constraint, constraint(), constraintChanged(), QtRectFPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtRectFPropertyManagerPrivate::setConstraint(), QtRectFPropertyManagerPrivate::Data::val, and valueChanged().
|
slot |
Sets the precision of the given property to prec.
The valid decimal range is 0-13. The default is 2.
References QtRectFPropertyManagerPrivate::Data::decimals, decimalsChanged(), QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, and QtDoublePropertyManager::setDecimals().
|
slot |
Sets the value of the given property to value. Nested properties are updated automatically.
If the specified value is not inside the given property's constraining rectangle, the value is adjusted accordingly to fit within the constraint.
References QtRectFPropertyManagerPrivate::Data::constraint, QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtDoublePropertyManager::setValue(), QtRectFPropertyManagerPrivate::Data::val, and valueChanged().
Referenced by QtRectFPropertyManagerPrivate::slotDoubleChanged().
QtDoublePropertyManager * QtRectFPropertyManager::subDoublePropertyManager | ( | ) | const |
Returns the manager that creates the nested x, y, width and height subproperties.
In order to provide editing widgets for the mentioned subproperties in a property browser widget, this manager must be associated with an editor factory.
References QtRectFPropertyManagerPrivate::m_doublePropertyManager.
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References QtRectFPropertyManagerPrivate::m_hToProperty, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtRectFPropertyManagerPrivate::m_wToProperty, QtRectFPropertyManagerPrivate::m_xToProperty, and QtRectFPropertyManagerPrivate::m_yToProperty.
QRectF QtRectFPropertyManager::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 rectangle.
References QtRectFPropertyManagerPrivate::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 QtRectFPropertyManager(), setConstraint(), and setValue().
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References QtRectFPropertyManagerPrivate::m_values.