telepathy-glib API Reference Manual: TpAutomaticClientFactory

TpAutomaticClientFactory

TpAutomaticClientFactory — Factory for specialized TpChannel subclasses.

Functions

Types and Values

struct	TpAutomaticClientFactory
struct	TpAutomaticClientFactoryClass

Object Hierarchy

    GObject
    ╰── TpClientFactory
        ╰── TpAutomaticClientFactory

Includes

#include <telepathy-glib/telepathy-glib.h>

Description

This factory overrides some TpClientFactory virtual methods to create specialized TpChannel subclasses.

TpAutomaticClientFactory will currently create TpChannel objects as follows:

a TpStreamTubeChannel, if the channel is of type TP_IFACE_CHANNEL_TYPE_STREAM_TUBE;
a TpDBusTubeChannel, if the channel is of type TP_IFACE_CHANNEL_TYPE_DBUS_TUBE;
a TpTextChannel, if the channel is of type TP_IFACE_CHANNEL_TYPE_TEXT and implements TP_IFACE_CHANNEL_INTERFACE_MESSAGES;
a TpFileTransferChannel, if the channel is of type TP_IFACE_CHANNEL_TYPE_FILE_TRANSFER;
a TpCallChannel, if the channel is of type TP_IFACE_CHANNEL_TYPE_CALL;
a plain TpChannel, otherwise

It is guaranteed that the objects returned by future versions will be either the class that is currently used, or a more specific subclass of that class.

This factory asks to prepare the following features:

TP_CHANNEL_FEATURE_CORE for all channel types.
TP_FILE_TRANSFER_CHANNEL_FEATURE_CORE for TpFileTransferChannel
TP_CALL_CHANNEL_FEATURE_CORE for TpCallChannel
TP_DBUS_TUBE_CHANNEL_FEATURE_CORE for TpDBusTubeChannel

Functions

tp_automatic_client_factory_new ()

TpClientFactory *
tp_automatic_client_factory_new (GDBusConnection *dbus_connection);

Parameters

dbus_connection

a GDBusConnection

Returns

a new TpAutomaticClientFactory

Since 0.99.1

Types and Values

struct TpAutomaticClientFactory

struct TpAutomaticClientFactory;

Data structure representing a TpAutomaticClientFactory

Since 0.15.5

struct TpAutomaticClientFactoryClass

struct TpAutomaticClientFactoryClass {
    TpClientFactoryClass parent_class;
};

The class of a TpAutomaticClientFactory.

Members

TpClientFactoryClass parent_class;

the parent class

Since 0.15.5

TpAutomaticClientFactory

Functions

Types and Values

Object Hierarchy

Includes

Description

Functions

tp_automatic_client_factory_new ()

Parameters

Returns

Types and Values

struct TpAutomaticClientFactory

struct TpAutomaticClientFactoryClass

Members

See Also