The Gnome Chemistry Utils  0.14.0
Public Member Functions | List of all members
gcp::Mesomery Class Reference

#include <gcp/mesomery.h>

Inheritance diagram for gcp::Mesomery:
gcu::Object

Public Member Functions

 Mesomery ()
bool Load (xmlNodePtr node)
bool Build (std::set< Object * > const &Children) throw (std::invalid_argument)
void Transform2D (gcu::Matrix2D &m, double x, double y)
bool BuildContextualMenu (gcu::UIManager *UIManager, gcu::Object *object, double x, double y)
bool OnSignal (gcu::SignalId Signal, gcu::Object *Child)
bool Validate (bool split)
void Align ()
double GetYAlign ()
std::string Name ()
- Public Member Functions inherited from gcu::Object
 Object (TypeId Id=OtherType)
virtual ~Object ()
TypeId GetType () const
void SetId (gchar const *Id)
char const * GetId () const
virtual void AddChild (Object *object)
ObjectGetMolecule () const
ObjectGetReaction () const
ObjectGetGroup () const
DocumentGetDocument () const
ApplicationGetApplication () const
ObjectGetParentOfType (TypeId Id) const
ObjectGetChild (const gchar *Id) const
ObjectGetFirstChild (std::map< std::string, Object * >::iterator &i)
ObjectGetNextChild (std::map< std::string, Object * >::iterator &i)
ObjectGetDescendant (const char *Id) const
ObjectGetParent () const
void SetParent (Object *Parent)
virtual xmlNodePtr Save (xmlDocPtr xml) const
virtual bool GetCoords (double *x, double *y, double *z=NULL) const
virtual void Move (double x, double y, double z=0.)
bool SaveChildren (xmlDocPtr xml, xmlNodePtr node) const
void SaveId (xmlNodePtr node) const
xmlNodePtr GetNodeByProp (xmlNodePtr node, char const *Property, char const *Id)
xmlNodePtr GetNextNodeByProp (xmlNodePtr node, char const *Property, char const *Id)
xmlNodePtr GetNodeByName (xmlNodePtr node, char const *Name)
xmlNodePtr GetNextNodeByName (xmlNodePtr node, char const *Name)
bool HasChildren () const
unsigned GetChildrenNumber () const
virtual ObjectGetAtomAt (double x, double y, double z=0.)
virtual bool Build (std::set< Object * > const &Children) throw (std::invalid_argument)
void EmitSignal (SignalId Signal)
void Lock (bool state=true)
bool IsLocked ()
ObjectGetFirstLink (std::set< Object * >::iterator &i)
ObjectGetNextLink (std::set< Object * >::iterator &i)
void Link (Object *object)
void Unlink (Object *object)
virtual void OnUnlink (Object *object)
void GetPossibleAncestorTypes (std::set< TypeId > &types) const
virtual bool SetProperty (unsigned property, char const *value)
virtual std::string GetProperty (unsigned property) const
virtual void OnLoaded ()
void SetDirty (bool dirty=true)
virtual void Clear ()
std::string Identity ()
virtual char const * HasPropertiesDialog () const
virtual bool CanSelect () const
virtual void NotifyEmpty ()
void ShowPropertiesDialog ()
bool GetDirty (void) const

Additional Inherited Members

- Static Public Member Functions inherited from gcu::Object
static TypeId AddType (std::string TypeName, Object *(*CreateFunc)(), TypeId id=OtherType)
static void AddAlias (TypeId id, std::string TypeName)
static ObjectCreateObject (const std::string &TypeName, Object *parent=NULL)
static TypeId GetTypeId (const std::string &Name)
static std::string GetTypeName (TypeId Id)
static void AddMenuCallback (TypeId Id, BuildMenuCb cb)
static void AddRule (TypeId type1, RuleId rule, TypeId type2)
static void AddRule (const std::string &type1, RuleId rule, const std::string &type2)
static const std::set< TypeId > & GetRules (TypeId type, RuleId rule)
static const std::set< TypeId > & GetRules (const std::string &type, RuleId rule)
static void SetCreationLabel (TypeId Id, std::string Label)
static const std::string & GetCreationLabel (TypeId Id)
static const std::string & GetCreationLabel (const std::string &TypeName)
static SignalId CreateNewSignalId ()
- Protected Member Functions inherited from gcu::Object
virtual DialogBuildPropertiesDialog ()

Detailed Description

Represents mesomery relationships.

Definition at line 41 of file mesomery.h.

Constructor & Destructor Documentation

gcp::Mesomery::Mesomery ( )

The default constructor. Builds a new empty mesomery relationship.

Member Function Documentation

void gcp::Mesomery::Align ( )

Aligns the children.

bool gcp::Mesomery::Build ( std::set< Object * > const &  Children) throw (std::invalid_argument)
Parameters
Childrenthe molecules and arrow involved in the mesomery.

Tries to associate mesomers and arrows so that the relationship is clearly established and aligns the objects. On failure, it throws an std::invalid_argument exception.

Returns
true on success.
bool gcp::Mesomery::BuildContextualMenu ( gcu::UIManager UIManager,
gcu::Object object,
double  x,
double  y 
)
virtual
Parameters
UIManagerthe gcu::UIManager to populate.
objectthe Object on which occured the mouse click.
xx coordinate of the mouse click.
yy coordinate of the mouse click.

Builds the contextual menu for the mesomery.

Returns
true (failure would be a bug).

Reimplemented from gcu::Object.

double gcp::Mesomery::GetYAlign ( )
virtual
Returns
the alignment ordinate of the top mesomer.

Reimplemented from gcu::Object.

bool gcp::Mesomery::Load ( xmlNodePtr  node)
virtual
Parameters
node,:a pointer to the xmlNode containing the serialized arrow.

Used to load an arrow in memory.

Returns
true on succes, false otherwise.

Reimplemented from gcu::Object.

std::string gcp::Mesomery::Name ( )
virtual
Returns
the localized object generic name.

Reimplemented from gcu::Object.

bool gcp::Mesomery::OnSignal ( gcu::SignalId  Signal,
gcu::Object Child 
)
virtual
Parameters
Signalthe appropriate SignalId
Childthe child which emitted the signal or NULL

This function is called by the framework one of the molecules or arrows has changed. Realigns if the mesomery is still valid or destroys it.

Returns
true to propagate the signal to the parent.

Reimplemented from gcu::Object.

void gcp::Mesomery::Transform2D ( gcu::Matrix2D m,
double  x,
double  y 
)
virtual
Parameters
mthe Matrix2D of the transformation.
xthe x component of the center of the transformation.
ythe y component of the center of the transformation.

Mesomeries can't be currently rotated. This method don't do anything. It is just there to inhibit the default behavior.

Reimplemented from gcu::Object.

bool gcp::Mesomery::Validate ( bool  split)
Parameters
splitwhether to split the mesomery when arrows are missing.

Checks the validity of the mesomery, at least that each arrow is associated with two mesomers and all mesomers are related by arrows. Currently it does not check that the molecules are really mesomeric, but this might be implemented in the future.

Returns
true if the mesomery is valid or could be splitted, false otherwise.

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