telepathy-glib API Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy |
#include <telepathy-glib/telepathy-glib-dbus.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 |