NCL Composer  0.1.5
 All Classes Functions Variables Pages
PropertiesViewPlugin Class Reference

PropertiesViewPlugin is a Composer plugin that shows and enable the user to edit the a current selected Entity. More...

#include <PropertiesViewPlugin.h>

Inheritance diagram for PropertiesViewPlugin:
Collaboration diagram for PropertiesViewPlugin:

Public Slots

void onEntityAdded (QString pluginID, Entity *)
 This is called by the core when a new Entity is added. More...
 
void onEntityChanged (QString pluginID, Entity *)
 Called by the core when an Entity is changed. More...
 
void onEntityRemoved (QString pluginID, QString entityID)
 Called by the core after the entity entityID is removed. More...
 
void errorMessage (QString error)
 This is called by the core when some error triggered by this plugin instance occurs. More...
 
void changeSelectedEntity (QString pluginID, void *)
 
void validationError (QString pluginID, void *param)
 
virtual void updateFromModel ()
 Calls the plugin to update its internal model from model. More...
 
virtual void onEntityAdded (QString pluginID, Entity *entity)
 This is called by the core when a new Entity is added. More...
 
virtual void onEntityChanged (QString pluginID, Entity *entity)
 Called by the core when an Entity is changed. More...
 

Signals

void addEntity (QString type, QString parentEntityId, QMap< QString, QString > &atts, bool force)
 This message can be used to add a new entity in the model. More...
 
void setAttributes (Entity *entity, QMap< QString, QString > atts, bool force)
 This message can be used to edit the attributes of an Entity. More...
 
void removeEntity (Entity *entity, bool force)
 This message can be used to ask the core to remove an Entity. More...
 
void setListenFilter (const QStringList &entityTypes)
 Say the core that the plugin is interested in just the entities of the the type passed as parameter. More...
 
void sendBroadcastMessage (const char *msg, void *obj)
 Can be used to extend the current messages of Core. More...
 
void setPluginData (QByteArray data)
 Each plugin is able to save its specific data by calling this message. More...
 
void setCurrentProjectAsDirty ()
 TODO. More...
 

Public Member Functions

 PropertiesViewPlugin ()
 Constructor.
 
 ~PropertiesViewPlugin ()
 Destructor.
 
void init ()
 This function is part of the IPlugin API.
 
QWidget * getWidget ()
 Returns the widget of that plugin. More...
 
bool saveSubsession ()
 Save the specific data of this plugin. More...
 
QString getPluginInstanceID ()
 
void setPluginInstanceID (QString pluginInstID)
 
void setLanguageProfile (ILanguageProfile *languageProfile)
 
ILanguageProfilegetLanguageProfile ()
 
void setProject (Project *project)
 This call is used by the core to bind an existing NclDocument with this plugin instance. More...
 
ProjectgetProject ()
 This call is used by the core to recover the Project instance previously binded with this plugin instance. More...
 

Protected Attributes

Projectproject
 The Project binded with this particular plugin instance.
 
QString pluginInstanceID
 Each plugin instance also receives a unique instance ID (given by the core).
 
QMutex mutex
 
ILanguageProfilelanguageProfile
 

Detailed Description

PropertiesViewPlugin is a Composer plugin that shows and enable the user to edit the a current selected Entity.

Definition at line 36 of file PropertiesViewPlugin.h.

Member Function Documentation

void composer::extension::IPlugin::addEntity ( QString  type,
QString  parentEntityId,
QMap< QString, QString > &  atts,
bool  force 
)
signalinherited

This message can be used to add a new entity in the model.

Parameters
type
parentEntityId
atts
force
void PropertiesViewPlugin::changeSelectedEntity ( QString  pluginID,
void *  param 
)
slot
Parameters

Definition at line 95 of file PropertiesViewPlugin.cpp.

Here is the call graph for this function:

void PropertiesViewPlugin::errorMessage ( QString  error)
slot

This is called by the core when some error triggered by this plugin instance occurs.

Parameters
errorA description of the error.

Definition at line 48 of file PropertiesViewPlugin.cpp.

Project* composer::extension::IPlugin::getProject ( )
inlineinherited

This call is used by the core to recover the Project instance previously binded with this plugin instance.

Returns
project aProject instance

Definition at line 90 of file IPlugin.h.

QWidget * PropertiesViewPlugin::getWidget ( )
virtual

Returns the widget of that plugin.

This widget will be presentated to the user.

This function is part of the IPlugin API.

Returns
QWidget* the widget that represents this plugin. If NULL, the plugin has not a visual representation

Reimplemented from composer::extension::IPlugin.

Definition at line 38 of file PropertiesViewPlugin.cpp.

void PropertiesViewPlugin::onEntityAdded ( QString  pluginID,
Entity *  entity 
)
slot

This is called by the core when a new Entity is added.

This function is part of IPlugin API.

Parameters
pluginIDthe plugin instance id that first called the changes to the entity.
entitythe Entity that was added.

Definition at line 43 of file PropertiesViewPlugin.cpp.

virtual void composer::extension::IPlugin::onEntityAdded ( QString  pluginID,
Entity entity 
)
inlinevirtualslotinherited

This is called by the core when a new Entity is added.

This call is invoked by the core when a new Entity (from that particular types the plugin is listening) is added in the model.

Definition at line 150 of file IPlugin.h.

void PropertiesViewPlugin::onEntityChanged ( QString  pluginID,
Entity *  entity 
)
slot

Called by the core when an Entity is changed.

This function is part of IPlugin API.

Parameters
pluginIDthe plugin instance id that first called the changes to the entity.
entityThe entity that was modified.

Definition at line 53 of file PropertiesViewPlugin.cpp.

virtual void composer::extension::IPlugin::onEntityChanged ( QString  pluginID,
Entity entity 
)
inlinevirtualslotinherited

Called by the core when an Entity is changed.

Parameters
pluginIDthe plugin instance id that first called the changes to the entity.
entityThe entity that was modified.

Definition at line 163 of file IPlugin.h.

void PropertiesViewPlugin::onEntityRemoved ( QString  pluginID,
QString  entityID 
)
slot

Called by the core after the entity entityID is removed.

Parameters
pluginIDthe plugin instance id that first called the changes to the entity.
entityIDthe entity's identifier that was removed.

Definition at line 65 of file PropertiesViewPlugin.cpp.

Here is the call graph for this function:

void composer::extension::IPlugin::removeEntity ( Entity entity,
bool  force 
)
signalinherited

This message can be used to ask the core to remove an Entity.

Parameters
entityThe pointer to the Entity must be removed.
forceIt should be true if the user want to remove that entity even the internal model will not be consistent.
bool PropertiesViewPlugin::saveSubsession ( )
virtual

Save the specific data of this plugin.

This function is part of the IPlugin API.

Returns
bool

Reimplemented from composer::extension::IPlugin.

Definition at line 78 of file PropertiesViewPlugin.cpp.

void composer::extension::IPlugin::sendBroadcastMessage ( const char *  msg,
void *  obj 
)
signalinherited

Can be used to extend the current messages of Core.

This message is send to all plugins without any validation. The content of the message can be any QObject and are useful to extend the default core message.

Always, the signature of the method msg implemented by an receiver must be an public slot like: void msg(QString pluginID, void *obj)

The core will call this msg method to each publin that implements it when sendBroadcastMethod is called.

Here is the caller graph for this function:

void composer::extension::IPlugin::setAttributes ( Entity entity,
QMap< QString, QString >  atts,
bool  force 
)
signalinherited

This message can be used to edit the attributes of an Entity.

Parameters
entity
atts
force

Here is the caller graph for this function:

void composer::extension::IPlugin::setCurrentProjectAsDirty ( )
signalinherited

TODO.

Todo:
This could be done with setBroadcastMessage?!
void composer::extension::IPlugin::setListenFilter ( const QStringList &  entityTypes)
signalinherited

Say the core that the plugin is interested in just the entities of the the type passed as parameter.

Parameters
entityTypesa list of strings that the plugin want to listen.
void composer::extension::IPlugin::setPluginData ( QByteArray  data)
signalinherited

Each plugin is able to save its specific data by calling this message.

Important: When the plugin send this message, the data overwrite the previously saved by this plugin.

Parameters
dataA byte array contatining the data that plugin wants to save.

Here is the caller graph for this function:

void composer::extension::IPlugin::setProject ( Project project)
inlineinherited

This call is used by the core to bind an existing NclDocument with this plugin instance.

Parameters
documentan NclDocument instance

Definition at line 78 of file IPlugin.h.

virtual void composer::extension::IPlugin::updateFromModel ( )
inlinevirtualslotinherited

Calls the plugin to update its internal model from model.

This call is invoked by the core in two situations:

  • When the user resquest an update to all plugins
  • When the plugin is loaded in runtime

In the second case, the plugin is loaded, but did no receive the previous modifications, so it has to be forceed to reload the Document*.

Definition at line 142 of file IPlugin.h.


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