#include <TelepathyQt4/Client/OptionalInterfaceFactory>
Public Member Functions | |
OptionalInterfaceFactory (DBusProxySubclass *this_) | |
~OptionalInterfaceFactory () | |
template<typename Interface > | |
Interface * | interface () const |
This class is included in the public API for the benefit of high-level proxies in extensions.
To use this helper in a subclass of DBusProxy (say, ExampleObject), ExampleObject should inherit privately from OptionalInterfaceFactory<ExampleObject>, and call OptionalInterfaceFactory(this) in its constructor's initialization list.
DBusProxySubclass | A subclass of DBusProxy |
Telepathy::Client::OptionalInterfaceFactory< DBusProxySubclass >::OptionalInterfaceFactory | ( | DBusProxySubclass * | this_ | ) | [inline] |
Telepathy::Client::OptionalInterfaceFactory< DBusProxySubclass >::~OptionalInterfaceFactory | ( | ) | [inline] |
Class destructor.
Frees all interface instances constructed by this factory.
Interface* Telepathy::Client::OptionalInterfaceFactory< DBusProxySubclass >::interface | ( | ) | const [inline] |
Return a pointer to a valid instance of a interface class, associated with the same remote object as the given main interface instance. The given main interface must be of the class the optional interface is generated for (for eg. ChannelInterfaceGroupInterface this means ChannelInterface) or a subclass.
First invocation of this method for a particular optional interface class will construct the instance; subsequent calls will return a pointer to the same instance.
The returned instance is freed when the factory is destroyed; using it after destroying the factory will likely produce a crash. As the instance is shared, it should not be freed directly.
Interface | Class of the interface instance to get. |
Referenced by Telepathy::Client::OptionalInterfaceFactory< Channel >::interface().