Computer Assited Medical Intervention Tool Kit  version 5.0
Public Slots | Signals | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
QtSizeFPropertyManager Class Reference

The QtSizeFPropertyManager provides and manages QSizeF properties. More...

#include <qtpropertymanager.h>

+ Inheritance diagram for QtSizeFPropertyManager:
+ Collaboration diagram for QtSizeFPropertyManager:

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
 

Private Member Functions

 Q_PRIVATE_SLOT (d_func(), void slotDoubleChanged(QtProperty *, double)) Q_PRIVATE_SLOT(d_func()
 

Private Attributes

QtSizeFPropertyManagerPrivate * d_ptr
 

Detailed Description

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.

See also
QtAbstractPropertyManager, QtDoublePropertyManager, QtSizePropertyManager

Constructor & Destructor Documentation

◆ QtSizeFPropertyManager()

QtSizeFPropertyManager::QtSizeFPropertyManager ( QObject *  parent = nullptr)

Creates a manager with the given parent.

References d_ptr, QtSizeFPropertyManagerPrivate::m_doublePropertyManager, QtAbstractPropertyManager::propertyDestroyed(), QtSizeFPropertyManagerPrivate::q_ptr, and valueChanged().

◆ ~QtSizeFPropertyManager()

QtSizeFPropertyManager::~QtSizeFPropertyManager ( )
override

Destroys this manager, and all the properties it has created.

References QtAbstractPropertyManager::clear(), and d_ptr.

+ Here is the call graph for this function:

Member Function Documentation

◆ decimals()

int QtSizeFPropertyManager::decimals ( const QtProperty *  property) const

Returns the given property's precision, in decimals.

See also
setDecimals()

References d_ptr, QtSizeFPropertyManagerPrivate::Data::decimals, and QtSizeFPropertyManagerPrivate::m_values.

Referenced by initializeProperty().

+ Here is the caller graph for this function:

◆ decimalsChanged

void QtSizeFPropertyManager::decimalsChanged ( QtProperty *  property,
int  prec 
)
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

See also
setDecimals()

Referenced by setDecimals().

+ Here is the caller graph for this function:

◆ initializeProperty()

void QtSizeFPropertyManager::initializeProperty ( QtProperty *  property)
overrideprotectedvirtual

\reimp

Implements QtAbstractPropertyManager.

References QtAbstractPropertyManager::addProperty(), QtProperty::addSubProperty(), d_ptr, 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().

+ Here is the call graph for this function:

◆ maximum()

QSizeF QtSizeFPropertyManager::maximum ( const QtProperty *  property) const

Returns the given property's maximum size value.

See also
setMaximum(), minimum(), setRange()

References d_ptr, and QtSizeFPropertyManagerPrivate::m_values.

◆ minimum()

QSizeF QtSizeFPropertyManager::minimum ( const QtProperty *  property) const

Returns the given property's minimum size value.

See also
setMinimum(), maximum(), setRange()

References d_ptr, and QtSizeFPropertyManagerPrivate::m_values.

◆ Q_PRIVATE_SLOT()

QtSizeFPropertyManager::Q_PRIVATE_SLOT ( d_func()  ,
void   slotDoubleChangedQtProperty *, double 
)
private

◆ rangeChanged

void QtSizeFPropertyManager::rangeChanged ( QtProperty *  property,
const QSizeF &  minimum,
const QSizeF &  maximum 
)
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.

See also
setRange()

Referenced by setMaximum(), setMinimum(), and setRange().

+ Here is the caller graph for this function:

◆ setDecimals

void QtSizeFPropertyManager::setDecimals ( QtProperty *  property,
int  prec 
)
slot

Sets the precision of the given property to prec.

The valid decimal range is 0-13. The default is 2.

See also
decimals()

References d_ptr, QtSizeFPropertyManagerPrivate::Data::decimals, decimalsChanged(), QtSizeFPropertyManagerPrivate::m_doublePropertyManager, QtSizeFPropertyManagerPrivate::m_propertyToH, QtSizeFPropertyManagerPrivate::m_propertyToW, QtSizeFPropertyManagerPrivate::m_values, and QtDoublePropertyManager::setDecimals().

+ Here is the call graph for this function:

◆ setMaximum

void QtSizeFPropertyManager::setMaximum ( QtProperty *  property,
const QSizeF &  maxVal 
)
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).

See also
maximum(), setRange(), rangeChanged()

References d_ptr, QtSizeFPropertyManagerPrivate::Data::maximumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::Data::setMaximumValue(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().

+ Here is the call graph for this function:

◆ setMinimum

void QtSizeFPropertyManager::setMinimum ( QtProperty *  property,
const QSizeF &  minVal 
)
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).

See also
minimum(), setRange(), rangeChanged()

References d_ptr, QtSizeFPropertyManagerPrivate::Data::minimumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::Data::setMinimumValue(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().

+ Here is the call graph for this function:

◆ setRange

void QtSizeFPropertyManager::setRange ( QtProperty *  property,
const QSizeF &  minimum,
const QSizeF &  maximum 
)
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).

See also
setMinimum(), setMaximum(), rangeChanged()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizeFPropertyManagerPrivate::setRange(), and valueChanged().

+ Here is the call graph for this function:

◆ setValue

void QtSizeFPropertyManager::setValue ( QtProperty *  property,
const QSizeF &  value 
)
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.

See also
value(), setRange(), valueChanged()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), QtSizeFPropertyManagerPrivate::setValue(), and valueChanged().

Referenced by QtSizeFPropertyManagerPrivate::slotDoubleChanged().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ subDoublePropertyManager()

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.

See also
QtAbstractPropertyBrowser::setFactoryForManager()

References d_ptr, and QtSizeFPropertyManagerPrivate::m_doublePropertyManager.

◆ uninitializeProperty()

void QtSizeFPropertyManager::uninitializeProperty ( QtProperty *  property)
overrideprotectedvirtual

\reimp

Reimplemented from QtAbstractPropertyManager.

References d_ptr, QtSizeFPropertyManagerPrivate::m_hToProperty, QtSizeFPropertyManagerPrivate::m_propertyToH, QtSizeFPropertyManagerPrivate::m_propertyToW, QtSizeFPropertyManagerPrivate::m_values, and QtSizeFPropertyManagerPrivate::m_wToProperty.

◆ value()

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

See also
setValue()

References d_ptr, and QtSizeFPropertyManagerPrivate::m_values.

◆ valueChanged

void QtSizeFPropertyManager::valueChanged ( QtProperty *  property,
const QSizeF &  value 
)
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.

See also
setValue()

Referenced by QtSizeFPropertyManager(), setMaximum(), setMinimum(), setRange(), and setValue().

+ Here is the caller graph for this function:

◆ valueText()

QString QtSizeFPropertyManager::valueText ( const QtProperty *  property) const
overrideprotectedvirtual

\reimp

Reimplemented from QtAbstractPropertyManager.

References d_ptr, and QtSizeFPropertyManagerPrivate::m_values.

Member Data Documentation

◆ d_ptr

QtSizeFPropertyManagerPrivate* QtSizeFPropertyManager::d_ptr
private

Referenced by decimals(), initializeProperty(), maximum(), minimum(), QtSizeFPropertyManager(), setDecimals(), setMaximum(), setMinimum(), setRange(), setValue(), subDoublePropertyManager(), uninitializeProperty(), value(), valueText(), and ~QtSizeFPropertyManager().

The documentation for this class was generated from the following files: