The StatechartEditorController class is the controller of the main widget of the Statechart Editor. More...

#include <ArmarXGui/gui-plugins/StatechartEditorPlugin/StatechartEditorController.h>

Inheritance diagram for StatechartEditorController:

Classes
struct	Config

Public Slots
void	closeAllTabs ()

void	connectToView (int tabIndex)

void	executeOpenedState (bool)

void	onStateTabChanged (int index)

void	openSelectedState ()

void	requestSave ()

void	searchAndOpenPaths (QStringList paths)

void	showCodeFileContent (const QString &path)

void	showNewStatechartGroupDialog ()

void	showOnBreakFunction ()

void	showOnEnterFunction ()

void	showOnExitFunction ()

void	showRunFunction ()

void	showStatechartEditorSettingsDialog ()

void	showStateCode (statechartmodel::StateInstancePtr stateInstance)

void	treeviewGroupsDoubleClicked (QModelIndex index)

Public Slots inherited from ArmarXWidgetController
void	configAccepted ()

void	configRejected ()

void	enableMainWidget (bool enable)

Public Member Functions
void	configured () override
	This function must be implemented by the user, if he supplies a config dialog. More...

QStringList	findAllStatechartGroupDefinitions (const QString &basePath)

QPointer< QDialog >	getConfigDialog (QWidget *parent) override
	getConfigDialog returns a pointer to the a configuration widget of this controller. More...

QPointer< QWidget >	getWidget () override
	getWidget returns a pointer to the a widget of this controller. More...

void	loadSettings (QSettings *settings) override
	Implement to load the settings that are part of the GUI configuration. More...

bool	onClose () override
	onClose is called before the DockWidget is closed. More...

void	onConnectComponent () override
	Pure virtual hook for the subclass. More...

void	onDisconnectComponent () override
	Hook for subclass. More...

void	onExitComponent () override
	Hook for subclass. More...

void	onInitComponent () override
	Pure virtual hook for the subclass. More...

void	openStatechartGroups (QStringList groups)

void	saveSettings (QSettings *settings) override
	Implement to save the settings as part of the GUI configuration. More...

	StatechartEditorController ()

void	storeAutoSaveSettings ()

	~StatechartEditorController () override

Public Member Functions inherited from ArmarXComponentWidgetControllerTemplate< StatechartEditorController >
QIcon	getWidgetCategoryIcon () const final override
	Implement this function to supply an icon for the category. More...

QIcon	getWidgetIcon () const final override
	Implement this function to supply an icon for the menu. More...

QString	getWidgetName () const final override
	Implement this function to specify the default name of your Widget. More...

Public Member Functions inherited from ArmarXComponentWidgetController
	ArmarXComponentWidgetController ()

std::string	getDefaultName () const override
	Retrieve default name of component. More...

Public Member Functions inherited from ArmarXWidgetController
	ArmarXWidgetController ()

void	enableMainWidgetAsync (bool enable)
	This function enables/disables the main widget asynchronously (if called from a non qt thread). More...

virtual QPointer< QWidget >	getCustomTitlebarWidget (QWidget *parent=0)
	getTitleToolbar returns a pointer to the a toolbar widget of this controller. More...

QString	getInstanceName ()

virtual QMainWindow *	getMainWindow ()
	Returns the ArmarX MainWindow. More...

virtual SoNode *	getScene ()
	Reimplementing this function and returning a SoNode* will show this SoNode in the 3DViewerWidget, so that you do not need to implement a viewer yourself. More...

virtual QPointer< QDialog >	getSceneConfigDialog (QWidget *parent=nullptr)
	Reimplementing this function and returning a QDialog* will enable a configuration button which opens the returned dialog. More...

QPointer< TipDialog >	getTipDialog () const
	Returns the default instance for the TipDialog used by all widgets (if not set otherwise). More...

virtual QIcon	getWidgetCategoryIcon () const
	Implement this function to supply an icon for the category. More...

virtual QIcon	getWidgetIcon () const
	Implement this function to supply an icon for the menu. More...

virtual QString	getWidgetName () const =0
	Implement this function to specify the default name of your Widget. More...

virtual void	onLockWidget ()

virtual void	onUnlockWidget ()

virtual void	postDocking ()
	postDocking is called after the widget has been docked into the main window. More...

bool	setInstanceName (QString instanceName)
	sets the name of this instance. More...

virtual void	setMainWindow (QMainWindow *mainWindow)

virtual void	setMutex3D (RecursiveMutexPtr const &mutex3D)
	This mutex is used to protect 3d scene updates. Usually called by the ArmarXGui main window on creation of this controller. More...

void	setTipDialog (QPointer< TipDialog > tipDialog)

	~ArmarXWidgetController () override

Public Member Functions inherited from Logging
SpamFilterDataPtr	deactivateSpam (float deactivationDurationSec=10.0f, const std::string &identifier="", bool deactivate=true) const
	disables the logging for the current line for the given amount of seconds. More...

MessageTypeT	getEffectiveLoggingLevel () const

	Logging ()

void	setLocalMinimumLoggingLevel (MessageTypeT level)
	With setLocalMinimumLoggingLevel the minimum verbosity-level of log-messages can be set. More...

void	setTag (const LogTag &tag)

void	setTag (const std::string &tagName)

virtual	~Logging ()

Public Member Functions inherited from Component
virtual void	componentPropertiesUpdated (const std::set< std::string > &changedProperties)
	Implement this function if you would like to react to changes in the properties. More...

void	forceComponentCreatedByComponentCreateFunc ()
	forces the flag to be set to true that the object instance was created by the Component::create function More...

std::vector< PropertyUserPtr >	getAdditionalPropertyUsers () const

template<typename PropertyType >
Property< PropertyType >	getProperty (const std::string &name)

template<typename PropertyType >
Property< PropertyType >	getProperty (const std::string &name) const

template<class T >
void	getProperty (std::atomic< T > &val, const std::string &name) const

template<class T >
void	getProperty (T &val, const std::string &name) const

template<class ProxyType >
ProxyType	getProxyFromProperty (const std::string &propertyName, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)
	Get a proxy whose name is specified by the given property. More...

template<class ProxyType >
void	getProxyFromProperty (ProxyType &proxy, const std::string &propertyName, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)

template<class TopicProxyType >
TopicProxyType	getTopicFromProperty (const std::string &propertyName)
	Get a topic proxy whose name is specified by the given property. More...

template<class TopicProxyType >
void	getTopicFromProperty (TopicProxyType &top, const std::string &propertyName)

void	initializeProperties (const std::string &configName, Ice::PropertiesPtr const &properties, const std::string &configDomain)
	initializes the properties of this component. More...

void	injectPropertyDefinitions (PropertyDefinitionsPtr &props) override

void	offeringTopicFromProperty (const std::string &propertyName)
	Offer a topic whose name is specified by the given property. More...

virtual void	preOnConnectComponent () override

virtual void	preOnInitComponent () override

bool	usingProxyFromProperty (const std::string &propertyName, const std::string &endpoints="")
	Use a proxy whose name is specified by the given property. More...

void	usingTopicFromProperty (const std::string &propertyName, bool orderedPublishing=false)
	Use a topic whose name is specified by the given property. More...

Public Member Functions inherited from ManagedIceObject
void	enableProfiler (bool enable)
	setProfiler allows setting ManagedIceObject::profiler to a new instance (if the new instance is actually not a null pointer) More...

std::string	generateSubObjectName (const std::string &subObjectName)
	Generates a unique name for a sub object from a general name. More...

ArmarXManagerPtr	getArmarXManager () const
	Returns the ArmarX manager used to add and remove components. More...

ManagedIceObjectConnectivity	getConnectivity () const
	Retrieve connectivity of the object (topcis as well as proxies) More...

IceManagerPtr	getIceManager () const
	Returns the IceManager. More...

VariantBasePtr	getMetaInfo (const std::string &id)

StringVariantBaseMap	getMetaInfoMap () const

std::string	getName () const
	Retrieve name of object. More...

Ice::ObjectAdapterPtr	getObjectAdapter () const
	Returns object's Ice adapter. More...

ArmarXObjectSchedulerPtr	getObjectScheduler () const

PeriodicTaskPtr	getPeriodicTask (const std::string &name)

Profiler::ProfilerPtr	getProfiler () const
	getProfiler returns an instance of armarx::Profiler More...

template<class ProxyTarg , class... Args>
void	getProxy (const char *name, IceInternal::ProxyHandle< ProxyTarg > &proxy, Args &&...args)

template<class ProxyType >
ProxyType	getProxy (const std::string &name, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)
	Retrieves a proxy object. More...

template<class ProxyTarg , class... Args>
void	getProxy (const std::string &name, IceInternal::ProxyHandle< ProxyTarg > &proxy, Args &&...args)

template<class ProxyTarg , class... Args>
void	getProxy (IceInternal::ProxyHandle< ProxyTarg > &proxy, const char *name, Args &&...args)

template<class ProxyTarg , class... Args>
void	getProxy (IceInternal::ProxyHandle< ProxyTarg > &proxy, const std::string &name, Args &&...args)
	Assigns a proxy to `proxy`. More...

Ice::ObjectPrx	getProxy (long timeoutMs=0, bool waitForScheduler=true) const
	Returns the proxy of this object (optionally it waits for the proxy) More...

template<class Prx >
Prx	getProxy (long timeoutMs=0, bool waitForScheduler=true) const

template<class ProxyType >
void	getProxy (ProxyType &proxy, const char *name, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)
	Overload to allow using string literals as name (solve ambiguous overload). More...

template<class Prx >
void	getProxy (Prx &prx, long timeoutMs=0, bool waitForScheduler=true) const

int	getState () const
	Retrieve current state of the ManagedIceObject. More...

template<class TopicProxyType >
TopicProxyType	getTopic (const std::string &name)
	Returns a proxy of the specified topic. More...

template<class TopicProxyType >
void	getTopic (TopicProxyType &topicProxy, const std::string &name)
	Assigns a proxy of the specified topic to `topicProxy`. More...

std::vector< std::string >	getUnresolvedDependencies () const
	returns the names of all unresolved dependencies More...

	ManagedIceObject (ManagedIceObject const &other)

void	offeringTopic (const std::string &name)
	Registers a topic for retrival after initialization. More...

void	preambleGetTopic (std::string const &name)

void	setMetaInfo (const std::string &id, const VariantBasePtr &value)
	Allows to set meta information that can be queried live via Ice interface on the ArmarXManager. More...

void	startPeriodicTask (const std::string &uniqueName, std::function< void(void)> f, int periodMs, bool assureMeanInterval=false, bool forceSystemTime=true)

bool	stopPeriodicTask (const std::string &name)

bool	unsubscribeFromTopic (const std::string &name)
	Unsubscribe from a topic. More...

bool	usingProxy (const std::string &name, const std::string &endpoints="")
	Registers a proxy for retrieval after initialization and adds it to the dependency list. More...

void	usingTopic (const std::string &name, bool orderedPublishing=false)
	Registers a proxy for subscription after initialization. More...

void	waitForObjectScheduler ()
	Waits until the ObjectScheduler could resolve all dependencies. More...

void	waitForProxy (std::string const &name, bool addToDependencies)

Public Member Functions inherited from PropertyUser
std::vector< std::string >	getComponentProxyNames ()

Ice::PropertiesPtr	getIceProperties () const
	Returns the set of Ice properties. More...

template<typename PropertyType >
Property< PropertyType >	getProperty (const std::string &name)
	Property creation and retrieval. More...

template<typename PropertyType >
Property< PropertyType >	getProperty (const std::string &name) const
	Hack to allow using getProperty in `const`-modified methods. More...

template<class T >
void	getProperty (std::atomic< T > &val, const std::string &name) const

template<class T >
void	getProperty (T &val, const std::string &name) const

template<class T >
std::vector< T >	getPropertyAsCSV (const std::string &name, const std::string &splitBy=",;", bool trimElements=true, bool removeEmptyElements=true)

template<class ContainerT >
void	getPropertyAsCSV (ContainerT &val, const std::string &name, const std::string &splitBy=",;", bool trimElements=true, bool removeEmptyElements=true)

PropertyDefinitionsPtr	getPropertyDefinitions ()
	Returns the component's property definition container. More...

std::vector< std::string >	getSubscribedTopicNames ()

std::vector< std::string >	getTopicProxyNames ()

bool	hasProperty (const std::string &name)

	PropertyUser ()

virtual void	setIceProperties (Ice::PropertiesPtr properties)
	Sets the Ice properties. More...

bool	tryAddProperty (const std::string &propertyName, const std::string &value)

virtual void	updateIceProperties (const std::map< std::string, std::string > &changes)

void	updateProperties ()

void	updateProxies (IceManagerPtr)

	~PropertyUser () override

Static Public Member Functions
static QIcon	GetWidgetCategoryIcon ()

static QIcon	GetWidgetIcon ()

static QString	GetWidgetName ()

Static Public Member Functions inherited from ArmarXComponentWidgetController
template<typename Class >
static ArmarXWidgetControllerPtr	createInstance ()

Static Public Member Functions inherited from ArmarXWidgetController
template<typename Class >
static ArmarXWidgetControllerPtr	createInstance ()

static QIcon	GetWidgetCategoryIcon ()
	Implement this function to supply an icon for the menu (if you implemented static QString GetWidgetName()). More...

static QIcon	GetWidgetIcon ()
	Implement this function to supply an icon for the menu (if you implemented static QString GetWidgetName()). More...

static int	showMessageBox (const QString &msg)

Static Public Member Functions inherited from Component
template<class T , class TPtr = IceInternal::Handle<T>>
static TPtr	create (Ice::PropertiesPtr properties=Ice::createProperties(), const std::string &configName="", const std::string &configDomain="ArmarX")
	Factory method for a component. More...

Static Public Member Functions inherited from ManagedIceObject
static std::string	generateSubObjectName (const std::string &superObjectName, const std::string &subObjectName)
	Generates a unique name for a sub object from a general name and unique name. More...

static std::string	GetObjectStateAsString (int state)

Public Attributes
struct armarx::StatechartEditorController::Config	config

Additional Inherited Members
Public Types inherited from ArmarXWidgetController
using	RecursiveMutex = std::recursive_mutex

using	RecursiveMutexLock = std::unique_lock< RecursiveMutex >

using	RecursiveMutexLockPtr = std::shared_ptr< RecursiveMutexLock >

using	RecursiveMutexPtr = std::shared_ptr< RecursiveMutex >

Public Types inherited from ManagedIceObject
using	PeriodicTaskPtr = IceUtil::Handle< SimplePeriodicTask< std::function< void(void)> >>

Signals inherited from ArmarXWidgetController
void	configAccepted (ArmarXWidgetControllerPtr widget)

void	configRejected (ArmarXWidgetControllerPtr widget)

Static Public Attributes inherited from ManagedIceObject
static const ManagedIceObjectPtr	NullPtr
	A nullptr to be used when a const ref to a nullptr is required. More...

Protected Member Functions inherited from ArmarXComponentWidgetController
bool	onClose () override
	If you overwrite this method, make sure to call this implementation at the end of your implementation with ArmarXComponentWidgetController::onClose(). More...

Protected Member Functions inherited from Logging
bool	checkLogLevel (MessageTypeT level) const

const LogSenderPtr &	getLogSender () const
	Retrieve log sender. More...

LogSenderPtr	loghelper (const char file, int line, const char function) const

Protected Member Functions inherited from Component
void	addPropertyUser (const PropertyUserPtr &subPropertyUser)
	Add additional property users here that should show up in the application help text. More...

	Component ()
	Protected default constructor. Used for virtual inheritance. Use createManagedIceObject() instead. More...

PropertyDefinitionsPtr	createPropertyDefinitions () override

std::string	getConfigDomain ()
	Retrieve config domain for this component as set in constructor. More...

std::string	getConfigIdentifier ()
	Retrieve config identifier for this component as set in constructor. More...

std::string	getConfigName ()
	Retrieve config name for this component as set in constructor. More...

virtual void	icePropertiesInitialized ()

Protected Member Functions inherited from ManagedIceObject
template<class PluginT , class... ParamsT>
PluginT *	addPlugin (const std::string prefix="", ParamsT &&...params)

template<class PluginT , class... ParamsT>
void	addPlugin (PluginT *&targ, const std::string prefix="", ParamsT &&...params)

template<class PluginT , class... ParamsT>
void	addPlugin (std::experimental::observer_ptr< PluginT > &targ, const std::string prefix="", ParamsT &&...params)

Ice::CommunicatorPtr	getCommunicator () const

std::unique_ptr< ManagedIceObjectPlugin > &	getPluginPointer (std::type_info const &type, std::string const &prefix)

	ManagedIceObject ()
	Protected default constructor. More...

virtual void	postOnConnectComponent ()

virtual void	postOnDisconnectComponent ()

virtual void	postOnExitComponent ()

virtual void	postOnInitComponent ()

virtual void	preOnDisconnectComponent ()

virtual void	preOnExitComponent ()

bool	removeProxyDependency (const std::string &name)
	This function removes the dependency of this object on the in parameter name specified object. More...

void	setName (std::string name)
	Override name of well-known object. More...

void	terminate ()
	Initiates termination of this IceManagedObject. More...

	~ManagedIceObject () override

Protected Attributes inherited from ArmarXWidgetController
std::shared_ptr< std::recursive_mutex >	mutex3D

Protected Attributes inherited from Logging
MessageTypeT	minimumLoggingLevel

SpamFilterDataPtr	spamFilter

LogTag	tag

Detailed Description

The StatechartEditorController class is the controller of the main widget of the Statechart Editor.

Definition at line 134 of file StatechartEditorController.h.

Constructor & Destructor Documentation

◆ StatechartEditorController()

StatechartEditorController ( )

Definition at line 57 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ ~StatechartEditorController()

~StatechartEditorController ( )

override

Definition at line 69 of file StatechartEditorController.cpp.

Here is the call graph for this function:

Member Function Documentation

◆ closeAllTabs

void closeAllTabs ( )

slot

Definition at line 463 of file StatechartEditorController.cpp.

◆ configured()

void configured ( )

overridevirtual

This function must be implemented by the user, if he supplies a config dialog.

This function is then automatically called, when the dialog was accepted.

See also: getConfigDialog()

Reimplemented from ArmarXWidgetController.

Definition at line 896 of file StatechartEditorController.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ connectToView

void connectToView ( int tabIndex )

slot

Definition at line 338 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ executeOpenedState

void executeOpenedState ( bool )

slot

Definition at line 469 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ findAllStatechartGroupDefinitions()

QStringList findAllStatechartGroupDefinitions ( const QString & basePath )

Definition at line 84 of file StatechartEditorController.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getConfigDialog()

QPointer< QDialog > getConfigDialog ( QWidget * parent )

overridevirtual

getConfigDialog returns a pointer to the a configuration widget of this controller.

It is optional.

If you need your widget configured, before it is shown, you should implement this function and return a QDialog derived class.

Parameters

parent Pointer to the object, that should own this dialog.

Returns: pointer to a QDialog derived class, that should be used to configure your widget.

Note: When the dialog gets accepted (emit SIGNAL accepted()), the function configured() is called, which must be implemented as well.

See also: configured(), getWidget()

Reimplemented from ArmarXWidgetController.

Definition at line 907 of file StatechartEditorController.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getWidget()

QPointer< QWidget > getWidget ( )

overridevirtual

getWidget returns a pointer to the a widget of this controller.

This widget should be the main widget of this WidgetController. The standard implementation of this function creates a QWidget on the first call and assigns the pointer to the widget-member and returns the member.

Returns: pointer to the main widget.

Note: This function must always, at any time return a valid pointer. So if you reimplement it, you should create the widget in this function on the first call.

Reimplemented from ArmarXWidgetController.

Definition at line 688 of file StatechartEditorController.cpp.

Here is the caller graph for this function:

◆ GetWidgetCategoryIcon()

static QIcon GetWidgetCategoryIcon ( )

inlinestatic

Definition at line 179 of file StatechartEditorController.h.

◆ GetWidgetIcon()

static QIcon GetWidgetIcon ( )

inlinestatic

Definition at line 175 of file StatechartEditorController.h.

◆ GetWidgetName()

static QString GetWidgetName ( )

inlinestatic

Definition at line 171 of file StatechartEditorController.h.

◆ loadSettings()

void loadSettings ( QSettings * settings )

overridevirtual

Implement to load the settings that are part of the GUI configuration.

These settings are NOT loaded automatically on widget startup, but when a GUI config is loaded (instead of the optional config dialog).

Implements ArmarXWidgetController.

Definition at line 158 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ onClose()

bool onClose ( )

overridevirtual

onClose is called before the DockWidget is closed.

Returns: returns close, if the widget should really be closed

Reimplemented from ArmarXWidgetController.

Definition at line 888 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ onConnectComponent()

void onConnectComponent ( )

overridevirtual

Pure virtual hook for the subclass.

Is called once all dependencies of the object have been resolved and Ice connection is established. This hook is called whenever the dependencies are found. That means if the a depedency crashes or shuts down, the ManagedIceObject goes into disconnected state. When the dependencies are found again, this hook is called again.

See also: onDisconnectComponent()

Implements ManagedIceObject.

Definition at line 135 of file StatechartEditorController.cpp.

Here is the call graph for this function:

◆ onDisconnectComponent()

void onDisconnectComponent ( )

overridevirtual

Hook for subclass.

Is called if a dependency of the object got lost (crash, network error, stopped, ...). This hook should be the inverse to onConnectComponent(). So that onDisconnectComponent() and onConnectComponent() can be called alternatingly and the ManagedIceObject remains in valid states. *

See also: onConnectComponent

Reimplemented from ManagedIceObject.

Definition at line 144 of file StatechartEditorController.cpp.

◆ onExitComponent()

void onExitComponent ( )

overridevirtual

Hook for subclass.

Is called once the component terminates. Use for cleanup. Only called once.

Reimplemented from ManagedIceObject.

Definition at line 149 of file StatechartEditorController.cpp.

◆ onInitComponent()

void onInitComponent ( )

overridevirtual

Pure virtual hook for the subclass.

Is called once initialization of the ManagedIceObject is done. This hook is called in the implenting class once and never again during the lifecyle of the object. This function is called as soon as the ManagedIceObject was added to the ArmarXManager. Called in an own thread and not the thread it was created in.

Implements ManagedIceObject.

Definition at line 129 of file StatechartEditorController.cpp.