OGF::CallableConnection Class Reference

A Connection between a signal and an abstract Callable object. More...

#include <OGF/gom/types/connection.h>

Inheritance diagram for OGF::CallableConnection:

Public Member Functions
	CallableConnection (Object *source, const std::string &sig_name, Callable *target)
	CallableConnection constructor. More...
bool	invoke_target (const ArgList &args, Any &ret_val) override
	Directly invokes the target with an arguments list, without any argument translation. More...
Public Member Functions inherited from OGF::Connection
	Connection (Object *source, const std::string &sig_name)
	Connection constructor. More...
virtual	~Connection ()
	Connection destructor.
virtual bool	invoke (const ArgList &args, Any &ret_val)
	Invokes the target with an arguments list. More...
Object *	source () const
	Gets the source. More...
const std::string &	signal_name () const
	Gets the signal name. More...
Connection *	add_arg (const std::string &name, const std::string &value)
	Adds an argument. More...
Connection *	rename_arg (const std::string &name, const std::string &new_name)
	Renames an argument. More...
Connection *	discard_arg (const std::string &name)
	Discards an argument. More...
void	remove ()
	Removes this connection from the slot it is connected to.
Public Member Functions inherited from OGF::Callable
	Callable ()
	Callable constructor.
	~Callable () override
	Callable destructor.
bool	invoke (const ArgList &args)
	Invokes a method by method name and argument list. More...
bool	invoke ()
	Invokes a method by method name. More...
Public Member Functions inherited from OGF::Object
	Object (bool transient=false)
	Object constructor. More...
virtual	~Object ()
	Object destructor.
virtual MetaClass *	meta_class () const
	Gets the meta class. More...
virtual void	set_meta_class (MetaClass *mclass)
	Sets the meta class. More...
unsigned int	id () const
	Gets the identifier of this object. More...
std::string	string_id () const
	Gets the unique string identifier. More...
bool	has_method (const std::string &method_name) const
	Tests whether a method is defined. More...
virtual bool	invoke_method (const std::string &method_name, const ArgList &args, Any &ret_val)
	Invokes a method by method name and argument list, and gets the return value. More...
bool	invoke_method (const std::string &method_name, const ArgList &args)
	Invokes a method by method name and argument list. More...
bool	invoke_method (const std::string &method_name)
	Invokes a method by method name. More...
bool	has_property (const std::string &prop_name) const
	Tests whether a property is defined. More...
virtual bool	get_property (const std::string &prop_name, std::string &prop_value) const
	Gets a property. More...
virtual Connection *	connect_signal_to_slot (const std::string &signal_name, Object *to, const std::string &slot_name)
	Connects a signal with a slot of another object. More...
virtual void	add_connection (Connection *connection)
	Adds a connection to this object. More...
virtual void	remove_connection (Connection *connection)
	Removes a connection to this object. More...
virtual void	get_element (index_t i, Any &value) const
	Gets an element by index. More...
virtual void	set_element (index_t i, const Any &value)
	Sets an element by index. More...
virtual void	search (const std::string &needle, const std::string &path="")
	Displays the names of all objects that contain a substring. More...
bool	get_signals_enabled () const
	Tests wheter signals are enabled. More...
void	set_signals_enabled (bool value)
	Enables or disables signals. More...
bool	get_slots_enabled () const
	Tests wheter slots are enabled. More...
void	set_slots_enabled (bool value)
	Enables or disables slots. More...
MetaClass *	get_meta_class () const
	Gets the meta class. More...
std::string	get_string_id () const
	Gets the unique string identifier. More...
virtual std::string	get_doc () const
	Gets the documentation. More...
virtual Sign	compare (const Object *other) const
	Compares this object with another one. More...
virtual bool	is_a (const MetaType *type) const
	Tests whether this object inherits a given type. More...
void	disconnect ()
	Removes all connections from signals of this objects. More...
void	enable_signals ()
	Enables signals.
void	disable_signals ()
	Disables signals.
void	enable_slots ()
	Enables slots.
void	disable_slots ()
	Disables slots.
void	set_properties (const ArgList &args)
	Sets several properties in a single call. More...
virtual bool	set_property (const std::string &name, const std::string &value)
	Sets an individual property. More...
void	help () const
	Displays some help about this object. More...
virtual bool	set_property (const std::string &name, const Any &value)
	Sets an individual property. More...
virtual bool	get_property (const std::string &prop_name, Any &prop_value) const
	Gets a property. More...
Public Member Functions inherited from GEO::Counted
void	ref () const
	Increments the reference count. More...
void	unref () const
	Decrements the reference count. More...
bool	is_shared () const
	Check if the object is shared. More...
int	nb_refs () const
	Gets the number of references that point to this object. More...

Additional Inherited Members
Static Public Member Functions inherited from OGF::Object
static Object *	id_to_object (unsigned int id)
	Gets an object from a unique object id. More...
Static Public Member Functions inherited from GEO::Counted
static void	ref (const Counted *counted)
	Increments the reference count. More...
static void	unref (const Counted *counted)
	Decrements the reference count. More...
Public Attributes inherited from OGF::Connection
	__pad0__: Connection* if_arg( const std::string& name
const std::string &	value
return	this
Public Attributes inherited from OGF::Object
	__pad0__: virtual index_t get_nb_elements() const
	__pad1__: bool equals(const Object* other) const
Protected Member Functions inherited from OGF::Connection
bool	test_arg_conditions (const ArgList &args) const
	Tests whether an argument list satisfies the argument conditions. More...
bool	test_arg_condition (const std::string &value, const std::string &condition) const
	Tests whether an argument satisfies a condition. More...
void	translate_args (const ArgList &args_in, ArgList &args_out)
	Applies all the argument list transformations. More...
Protected Member Functions inherited from OGF::Object
virtual bool	emit_signal (const std::string &signal_name, const ArgList &args, bool called_from_slot=false)
	Emits a signal and calls the slots it is connected to. More...
Protected Member Functions inherited from GEO::Counted
	Counted ()
	Creates a reference counted object. More...
virtual	~Counted ()
	Destroys a reference counted object. More...

Detailed Description

A Connection between a signal and an abstract Callable object.

It is not used for signal-slot connection because both CallableConnection and Request do reference counting on their arguments, thus this would prevent objects from being garbage-collected. For signal-slot connections, SlotConnection is used instead.

Definition at line 292 of file connection.h.

Constructor & Destructor Documentation

CallableConnection()

OGF::CallableConnection::CallableConnection	(	Object *	source,
		const std::string &	sig_name,
		Callable *	target
	)

CallableConnection constructor.

Parameters

[in]	source	a pointer to the source object
[in]	sig_name	the name of the source's signal
[in]	target	a pointer to the target Callable object

Target is reference-counted.

Member Function Documentation

invoke_target()

bool OGF::CallableConnection::invoke_target ( const ArgList &  args, Any &  ret_val  )

overridevirtual

Directly invokes the target with an arguments list, without any argument translation.

Parameters

[in]	args	a const reference to the arguments list
[out]	ret_val	on exit, contains "void".

Implements OGF::Connection.

---

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

• OGF/gom/types/connection.h