The QtSizePropertyManager provides and manages QSize properties. More...
#include <qtpropertymanager.h>
Public Slots | |
void | setMaximum (QtProperty *property, const QSize &maxVal) |
void | setMinimum (QtProperty *property, const QSize &minVal) |
void | setRange (QtProperty *property, const QSize &minVal, const QSize &maxVal) |
void | setValue (QtProperty *property, const QSize &val) |
Signals | |
void | rangeChanged (QtProperty *property, const QSize &minVal, const QSize &maxVal) |
void | valueChanged (QtProperty *property, const QSize &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 | |
QSize | maximum (const QtProperty *property) const |
QSize | minimum (const QtProperty *property) const |
QtSizePropertyManager (QObject *parent=nullptr) | |
QtIntPropertyManager * | subIntPropertyManager () const |
QSize | value (const QtProperty *property) const |
~QtSizePropertyManager () 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 Member Functions | |
Q_PRIVATE_SLOT (d_func(), void slotIntChanged(QtProperty *, int)) Q_PRIVATE_SLOT(d_func() | |
Private Attributes | |
QtSizePropertyManagerPrivate * | d_ptr |
The QtSizePropertyManager provides and manages QSize 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 QtIntPropertyManager object. This manager can be retrieved using the subIntPropertyManager() 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, QtSizePropertyManager 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.
QtSizePropertyManager::QtSizePropertyManager | ( | QObject * | parent = nullptr | ) |
Creates a manager with the given parent.
References d_ptr, QtSizePropertyManagerPrivate::m_intPropertyManager, QtAbstractPropertyManager::propertyDestroyed(), QtSizePropertyManagerPrivate::q_ptr, and valueChanged().
|
override |
Destroys this manager, and all the properties it has created.
References QtAbstractPropertyManager::clear(), and d_ptr.
|
overrideprotectedvirtual |
\reimp
Implements QtAbstractPropertyManager.
References QtAbstractPropertyManager::addProperty(), QtProperty::addSubProperty(), d_ptr, QtSizePropertyManagerPrivate::m_hToProperty, QtSizePropertyManagerPrivate::m_intPropertyManager, QtSizePropertyManagerPrivate::m_propertyToH, QtSizePropertyManagerPrivate::m_propertyToW, QtSizePropertyManagerPrivate::m_values, QtSizePropertyManagerPrivate::m_wToProperty, QtIntPropertyManager::setMinimum(), QtProperty::setPropertyName(), and QtIntPropertyManager::setValue().
QSize QtSizePropertyManager::maximum | ( | const QtProperty * | property | ) | const |
Returns the given property's maximum size value.
References d_ptr, and QtSizePropertyManagerPrivate::m_values.
QSize QtSizePropertyManager::minimum | ( | const QtProperty * | property | ) | const |
Returns the given property's minimum size value.
References d_ptr, and QtSizePropertyManagerPrivate::m_values.
|
private |
|
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 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 d_ptr, QtSizePropertyManagerPrivate::Data::maximumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizePropertyManagerPrivate::Data::setMaximumValue(), QtSizePropertyManagerPrivate::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 d_ptr, QtSizePropertyManagerPrivate::Data::minimumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizePropertyManagerPrivate::Data::setMinimumValue(), QtSizePropertyManagerPrivate::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 d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizePropertyManagerPrivate::setRange(), and valueChanged().
Referenced by MainWindow::itemClicked().
|
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 d_ptr, QtAbstractPropertyManager::propertyChanged(), QtSizePropertyManagerPrivate::setValue(), and valueChanged().
Referenced by MainWindow::itemClicked(), and QtSizePropertyManagerPrivate::slotIntChanged().
QtIntPropertyManager * QtSizePropertyManager::subIntPropertyManager | ( | ) | 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 d_ptr, and QtSizePropertyManagerPrivate::m_intPropertyManager.
Referenced by main(), and MainWindow::MainWindow().
|
overrideprotectedvirtual |
QSize QtSizePropertyManager::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 d_ptr, and QtSizePropertyManagerPrivate::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 QtSizePropertyManager(), setMaximum(), setMinimum(), setRange(), and setValue().
|
overrideprotectedvirtual |
\reimp
Reimplemented from QtAbstractPropertyManager.
References d_ptr, and QtSizePropertyManagerPrivate::m_values.
|
private |