Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QDesignerPropertyEditorInterface Class Reference
^{[ QtDesigner module]}

The QDesignerPropertyEditorInterface class allows you to query and manipulate the current state of Qt Designer's property editor. Далее...

 #include <QDesignerPropertyEditorInterface>

Наследует QWidget.

• Список всех членов, включая унаследованные

[править] Открытые функции

• QDesignerPropertyEditorInterface ( QWidget * parent, Qt::WindowFlags flags = 0 )
• virtual ~QDesignerPropertyEditorInterface ()
• virtual QDesignerFormEditorInterface * core () const
• virtual QString currentPropertyName () const = 0
• virtual bool isReadOnly () const = 0
• virtual QObject * object () const = 0

• 201 свойство, унаследованное от QWidget
• 29 открытых функций, унаследованных от QObject
• 12 открытых функций, унаследованных от QPaintDevice

[править] Открытые слоты

• virtual void setObject ( QObject * object ) = 0
• virtual void setPropertyValue ( const QString & name, const QVariant & value, bool changed = true ) = 0
• virtual void setReadOnly ( bool readOnly ) = 0

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

[править] Сигналы

• void propertyChanged ( const QString & name, const QVariant & value )

• 1 сигнал, унаследованный от QWidget
• 1 сигнал, унаследованный от QObject

[править] Дополнительные унаследованные члены

• 56 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject
• 4 статических открытых члена, унаследованных от QWidget
• 5 статических открытых членов, унаследованных от QObject
• 38 защищенных функций, унаследованных от QWidget
• 7 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованных от QPaintDevice
• 1 защищенный слот, унаследованый от QWidget

[править] Подробное описание

The QDesignerPropertyEditorInterface class allows you to query and manipulate the current state of Qt Designer's property editor.

QDesignerPropertyEditorInterface contains a collection of functions that is typically used to query the property editor for its current state, and several slots manipulating it's state. The interface also provide a signal, propertyChanged(), which is emitted whenever a property changes in the property editor. The signal's arguments are the property that changed and its new value.

For example, when implementing a custom widget plugin, you can connect the signal to a custom slot:

 QDesignerPropertyEditorInterface *propertyEditor = 0;
 propertyEditor = formEditor->propertyEditor();
 
 connect(propertyEditor, SIGNAL(propertyChanged(QString, QVariant)),
         this, SLOT(checkProperty(QString, QVariant)));

Then the custom slot can check if the new value is within the range we want when a specified property, belonging to a particular widget, changes:

 void checkProperty(QString property, QVariant value) {
     QDesignerPropertyEditorInterface *propertyEditor = 0;
     propertyEditor = formEditor->propertyEditor();
 
     QObject *object = propertyeditor->object();
     MyCustomWidget *widget = qobject_cast<MyCustomWidget>(object);
 
     if (widget &amp;&amp; property == aProperty &amp;&amp; value != expectedValue)
         {...}
 }

The QDesignerPropertyEditorInterface class is not intended to be instantiated directly. You can retrieve an interface to Qt Designers property editor using the QDesignerFormEditorInterface::propertyEditor() function. A pointer to Qt Designers current QDesignerFormEditorInterface object (formEditor in the examples above) is provided by the QDesignerCustomWidgetInterface::initialize() function's parameter. When implementing a custom widget plugin, you must subclass the QDesignerCustomWidgetInterface to expose your plugin to Qt Designer.

The functions accessing the property editor are the core() function that you can use to retrieve an interface to the form editor, the currentPropertyName() function that returns the name of the currently selected property in the property editor, the object() function that returns the currently selected object in Qt Designer's workspace, and the isReadOnly() function that returns true if the property editor is write proteced (otherwise false).

The slots manipulating the property editor's state are the setObject() slot that you can use to change the currently selected object in Qt Designer's workspace, the setPropertyValue() slot that changes the value of a given property and the setReadOnly() slot that control the write protection of the property editor.

See also QDesignerFormEditorInterface.

[править] Описание функций-членов

[править]

QDesignerPropertyEditorInterface::QDesignerPropertyEditorInterface ( QWidget * parent, Qt::WindowFlags flags = 0 )

Constructs a property editor interface with the given parent and the specified window flags.

[править]

QDesignerPropertyEditorInterface::~QDesignerPropertyEditorInterface () [virtual]

Destroys the property editor interface.

[править]

QDesignerFormEditorInterface * QDesignerPropertyEditorInterface::core () const [virtual]

Returns a pointer to Qt Designer's current QDesignerFormEditorInterface object.

[править]

QString QDesignerPropertyEditorInterface::currentPropertyName () const [pure virtual]

Returns the name of the currently selected property in the property editor.

See also setPropertyValue().

[править]

bool QDesignerPropertyEditorInterface::isReadOnly () const [pure virtual]

Returns true if the property editor is write protected; otherwise false.

See also setReadOnly().

[править]

QObject * QDesignerPropertyEditorInterface::object () const [pure virtual]

Returns the currently selected object in Qt Designer's workspace.

See also setObject().

[править]

void QDesignerPropertyEditorInterface::propertyChanged ( const QString & name, const QVariant & value ) [signal]

This signal is emitted whenever a property changes in the property editor. The property that changed and its new value are specified by name and value respectively.

See also setPropertyValue().

[править]

void QDesignerPropertyEditorInterface::setObject ( QObject * object ) [pure virtual slot]

Changes the currently selected object in Qt Designer's workspace, to object.

See also object().

[править]

void QDesignerPropertyEditorInterface::setPropertyValue ( const QString & name, const QVariant & value, bool changed = true ) [pure virtual slot]

Sets the value of the property specified by name to value.

In addition, the property is marked as changed in the property editor, i.e. its value is different from the default value.

See also currentPropertyName() and propertyChanged().

[править]

void QDesignerPropertyEditorInterface::setReadOnly ( bool readOnly ) [pure virtual slot]

If readOnly is true, the property editor is made write protected; otherwise the write protection is removed.

See also isReadOnly().