| telepathy-glib API Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
#include <telepathy-glib/svc-channel.h>
TpSvcChannelInterfaceRoom;
TpSvcChannelInterfaceRoomClass;
TpSvcChannelInterfaceRoomConfig;
TpSvcChannelInterfaceRoomConfigClass;
void tp_svc_channel_interface_room_config_implement_update_configuration
(TpSvcChannelInterfaceRoomConfigClass *klass,
tp_svc_channel_interface_room_config_update_configuration_impl impl);
void tp_svc_channel_interface_room_config_return_from_update_configuration
(DBusGMethodInvocation *context);
void (*tp_svc_channel_interface_room_config_update_configuration_impl)
(TpSvcChannelInterfaceRoomConfig *self,
GHashTable *in_Properties,
DBusGMethodInvocation *context);
TpSvcChannelInterfaceSubject;
TpSvcChannelInterfaceSubjectClass;
void tp_svc_channel_interface_subject_implement_set_subject
(TpSvcChannelInterfaceSubjectClass *klass,
tp_svc_channel_interface_subject_set_subject_impl impl);
void tp_svc_channel_interface_subject_return_from_set_subject
(DBusGMethodInvocation *context);
void (*tp_svc_channel_interface_subject_set_subject_impl)
(TpSvcChannelInterfaceSubject *self,
const gchar *in_Subject,
DBusGMethodInvocation *context);
GInterface +----TpSvcChannelInterfaceRoom
GInterface +----TpSvcChannelInterfaceRoomConfig
GInterface +----TpSvcChannelInterfaceSubject
This collection of interfaces is used to expose various aspects of the configuration of chat rooms.
TpSvcChannelInterfaceRoom consists of a pair of requestable,
immutable properties: "RoomName" and
"Server"; and a pair of immutable properties:
"Creator", "CreatorHandle", and
"CreationTimestamp". It has no methods or signals. It
should be implemented on channels representing a chat room (whether
it be a text chat, a multi-user call, or some other media type).
TpSvcChannelInterfaceSubject may be implemented by channels which have a
subject (or topic, depending on your protocol's terminology of choice). This
will usually be in addition to TpSvcChannelInterfaceRoom, though in theory
a 1-1 channel could have a subject. In addition to its single method, it
defines a set of read-only properties, namely "Subject",
"Actor", "ActorHandle", "Timestamp",
and "CanSet". Changes should be signalled using
tp_dbus_properties_mixin_emit_properties_changed().
TpSvcChannelInterfaceRoomConfig provides a vast array of properties for other aspects of a chat room's configuration (such as the maximum number of participants, and whether the room is password-protected). Channels with this interface will typically implement the other two, too.
typedef struct _TpSvcChannelInterfaceRoom TpSvcChannelInterfaceRoom;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceRoomClass TpSvcChannelInterfaceRoomClass;
The class of TpSvcChannelInterfaceRoom.
This interface has no D-Bus methods, so an
implementation can typically pass NULL to
G_IMPLEMENT_INTERFACE() as the interface
initialization function.
typedef struct _TpSvcChannelInterfaceRoomConfig TpSvcChannelInterfaceRoomConfig;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceRoomConfigClass TpSvcChannelInterfaceRoomConfigClass;
The class of TpSvcChannelInterfaceRoomConfig.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE() would
typically look like this:
static void
implement_channel_interface_room_config (gpointer klass,
gpointer unused G_GNUC_UNUSED)
{
#define IMPLEMENT(x) tp_svc_channel_interface_room_config_implement_##x (\
klass, my_object_##x)
IMPLEMENT (update_configuration);
#undef IMPLEMENT
}
void tp_svc_channel_interface_room_config_implement_update_configuration (TpSvcChannelInterfaceRoomConfigClass *klass,tp_svc_channel_interface_room_config_update_configuration_impl impl);
Register an implementation for the UpdateConfiguration method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the UpdateConfiguration D-Bus method |
void tp_svc_channel_interface_room_config_return_from_update_configuration
(DBusGMethodInvocation *context);
Return successfully by calling dbus_g_method_return().
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void (*tp_svc_channel_interface_room_config_update_configuration_impl) (TpSvcChannelInterfaceRoomConfig *self,GHashTable *in_Properties,DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method UpdateConfiguration on interface org.freedesktop.Telepathy.Channel.Interface.RoomConfig1.
|
The object implementing this interface |
|
GHashTable * (FIXME, generate documentation) |
|
Used to return values or throw an error |
typedef struct _TpSvcChannelInterfaceSubject TpSvcChannelInterfaceSubject;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceSubjectClass TpSvcChannelInterfaceSubjectClass;
The class of TpSvcChannelInterfaceSubject.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE() would
typically look like this:
static void
implement_channel_interface_subject (gpointer klass,
gpointer unused G_GNUC_UNUSED)
{
#define IMPLEMENT(x) tp_svc_channel_interface_subject_implement_##x (\
klass, my_object_##x)
IMPLEMENT (set_subject);
#undef IMPLEMENT
}
void tp_svc_channel_interface_subject_implement_set_subject (TpSvcChannelInterfaceSubjectClass *klass,tp_svc_channel_interface_subject_set_subject_impl impl);
Register an implementation for the SetSubject method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the SetSubject D-Bus method |
void tp_svc_channel_interface_subject_return_from_set_subject
(DBusGMethodInvocation *context);
Return successfully by calling dbus_g_method_return().
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void (*tp_svc_channel_interface_subject_set_subject_impl) (TpSvcChannelInterfaceSubject *self,const gchar *in_Subject,DBusGMethodInvocation *context);
The signature of an implementation of the D-Bus method SetSubject on interface org.freedesktop.Telepathy.Channel.Interface.Subject2.
|
The object implementing this interface |
|
const gchar * (FIXME, generate documentation) |
|
Used to return values or throw an error |