Workspace 6.21.5
Public Slots | Signals | Public Member Functions | Protected Member Functions | List of all members
QtStringPropertyManager Class Reference

The QtStringPropertyManager provides and manages QString properties. More...

#include <Workspace/Widgets/PropertyBrowser/qtpropertymanager.h>

Inheritance diagram for QtStringPropertyManager:
[legend]

Public Slots

void setEchoMode (QtProperty *property, EchoMode echoMode)
 
void setRegExp (QtProperty *property, const QRegExp &regExp)
 
void setValue (QtProperty *property, const QString &val)
 

Signals

void echoModeChanged (QtProperty *property, const int)
 
void regExpChanged (QtProperty *property, const QRegExp &regExp)
 
void valueChanged (QtProperty *property, const QString &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

 QtStringPropertyManager (QObject *parent=nullptr)
 
 ~QtStringPropertyManager ()
 
EchoMode echoMode (const QtProperty *property) const
 
QRegExp regExp (const QtProperty *property) const
 
QString value (const QtProperty *property) const
 
- Public Member Functions inherited from QtAbstractPropertyManager
 QtAbstractPropertyManager (QObject *parent=nullptr)
 
 ~QtAbstractPropertyManager ()
 
QtPropertyaddProperty (const QString &name=QString())
 
void clear () const
 
bool getModifiedOnValueChanged () const
 
QSet< QtProperty * > properties () const
 
void setModifiedOnValueChanged (bool modified)
 

Protected Member Functions

QString displayText (const QtProperty *property) const
 
virtual void initializeProperty (QtProperty *property)
 
virtual void uninitializeProperty (QtProperty *property)
 
QString valueText (const QtProperty *property) const
 
- Protected Member Functions inherited from QtAbstractPropertyManager
virtual QtPropertycreateProperty ()
 
virtual QString displayText (const QtProperty *property) const
 
virtual EchoMode echoMode (const QtProperty *) const
 
virtual bool hasValue (const QtProperty *property) const
 
virtual void initializeProperty (QtProperty *property)=0
 
virtual void uninitializeProperty (QtProperty *property)
 
virtual QIcon valueIcon (const QtProperty *property) const
 
virtual QString valueText (const QtProperty *property) const
 

Detailed Description

A string property's value can be retrieved using the value() function, and set using the setValue() slot.

The current value can be checked against a regular expression. To set the regular expression use the setRegExp() slot, use the regExp() function to retrieve the currently set expression.

In addition, QtStringPropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes, and the regExpChanged() signal which is emitted whenever such a property changes its currently set regular expression.

See also
QtAbstractPropertyManager, QtLineEditFactory

Constructor & Destructor Documentation

◆ QtStringPropertyManager()

QtStringPropertyManager ( QObject *  parent = nullptr)

Creates a manager with the given parent.

◆ ~QtStringPropertyManager()

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

Member Function Documentation

◆ displayText()

QString displayText ( const QtProperty property) const
protectedvirtual

Returns a string representing the current state of the given property.

The default implementation of this function returns an empty string.

See also
QtProperty::valueText()

Reimplemented from QtAbstractPropertyManager.

◆ echoMode()

EchoMode echoMode ( const QtProperty property) const
virtual

Returns the echo mode representing the current state of the given property.

The default implementation of this function returns QLineEdit::Normal.

See also
QtProperty::valueText()

Reimplemented from QtAbstractPropertyManager.

◆ echoModeChanged

void echoModeChanged ( QtProperty property,
const int   
)
signal

◆ initializeProperty()

void initializeProperty ( QtProperty property)
protectedvirtual

This function is called whenever a new valid property pointer has been created, passing the pointer as parameter.

The purpose is to let the manager know that the property has been created so that it can provide additional attributes for the new property, e.g. QtIntPropertyManager adds {QtIntPropertyManager::value()}{value}, {QtIntPropertyManager::minimum()}{minimum} and {QtIntPropertyManager::maximum()}{maximum} attributes. Since each manager subclass adds type specific attributes, this function is pure virtual and must be reimplemented when deriving from the QtAbstractPropertyManager class.

See also
addProperty(), createProperty()

Implements QtAbstractPropertyManager.

◆ regExp()

QRegExp regExp ( const QtProperty property) const

Returns the given property's currently set regular expression.

If the given property is not managed by this manager, this function returns an empty expression.

See also
setRegExp()

◆ regExpChanged

void regExpChanged ( QtProperty property,
const QRegExp &  regExp 
)
signal

This signal is emitted whenever a property created by this manager changes its currenlty set regular expression, passing a pointer to the property and the new regExp as parameters.

See also
setRegExp()

◆ setEchoMode

void setEchoMode ( QtProperty property,
EchoMode  echoMode 
)
slot

◆ setRegExp

void setRegExp ( QtProperty property,
const QRegExp &  regExp 
)
slot

Sets the regular expression of the given property to regExp.

See also
regExp(), setValue(), regExpChanged()

◆ setValue

void setValue ( QtProperty property,
const QString &  value 
)
slot

Sets the value of the given property to value.

If the specified value doesn't match the given property's regular expression, this function does nothing.

See also
value(), setRegExp(), valueChanged()

◆ uninitializeProperty()

void uninitializeProperty ( QtProperty property)
protectedvirtual

This function is called just before the specified property is destroyed.

The purpose is to let the property manager know that the property is being destroyed so that it can remove the property's additional attributes.

See also
clear(), propertyDestroyed()

Reimplemented from QtAbstractPropertyManager.

◆ value()

QString 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 empty string.

See also
setValue()

◆ valueChanged

void valueChanged ( QtProperty property,
const QString &  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()

◆ valueText()

QString valueText ( const QtProperty property) const
protectedvirtual

Returns a string representing the current state of the given property.

The default implementation of this function returns an empty string.

See also
QtProperty::valueText()

Reimplemented from QtAbstractPropertyManager.