| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/telepathy/_generated/ |
Upload File : |
L7Jc @ s2 d Z d d k Z d e i i f d YZ d S( s1 Copyright © 2005-2009 Collabora Limited
Copyright © 2005-2009 Nokia Corporation
Copyright © 2006 INdT
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
iNt ChannelInterfaceGroupc B si e Z d Z d Z e i i d d d d d d Z e i i d d d d d d Z e i i d d d d d
d Z e i i d d d d d d
Z
e i i d d d d d d Z e i i d d d d d d Z e i i d d d d d d Z
e i i d d d d d d Z e i i d d d d d
d Z e i i d d d d d d Z e i i d d d d d d Z e i i d d d d Z e i i d d d
d Z e i i d d d d Z e i i d d d d Z e i i d d d d Z RS(! s@ Interface for channels which have multiple members, and where the members
of the channel can change during its lifetime. Your presence in the channel
cannot be presumed by the channel's existence (for example, a channel you
may request membership of but your request may not be granted).
This interface implements three lists: a list of current members
(Members), and two lists of local pending
and remote pending members
(LocalPendingMembers and
RemotePendingMembers, respectively).
Contacts on the remote
pending list have been invited to the channel, but the remote user has not
accepted the invitation. Contacts on the local pending list have requested
membership of the channel, but the local user of the framework must accept
their request before they may join. A single contact should never appear on
more than one of the three lists. The lists are empty when the channel is
created, and the MembersChanged signal
(and, if the channel's GroupFlags contains
Members_Changed_Detailed, the
MembersChangedDetailed signal)
should be emitted when information
is retrieved from the server, or changes occur.
If the MembersChanged or
MembersChangedDetailed signal indicates
that the SelfHandle has been removed from
the channel, and the channel subsequently emits Closed,
clients SHOULD consider the details given in the MembersChanged or
MembersChangedDetailed signal to be the reason why the channel closed.
Addition of members to the channel may be requested by using
AddMembers. If
remote acknowledgement is required, use of the AddMembers method will cause
users to appear on the remote pending list. If no acknowledgement is
required, AddMembers will add contacts to the member list directly. If a
contact is awaiting authorisation on the local pending list, AddMembers
will grant their membership request.
Removal of contacts from the channel may be requested by using
RemoveMembers. If a contact is awaiting
authorisation on the local pending
list, RemoveMembers will refuse their membership request. If a contact is
on the remote pending list but has not yet accepted the invitation,
RemoveMembers will rescind the request if possible.
It should not be presumed that the requester of a channel implementing this
interface is immediately granted membership, or indeed that they are a
member at all, unless they appear in the list. They may, for instance,
be placed into the remote pending list until a connection has been
established or the request acknowledged remotely.
If the local user joins a Group channel whose members or other state
cannot be discovered until the user joins (e.g. many chat room
implementations), the connection manager should ensure that the channel
is, as far as possible, in a consistent state before adding the local
contact to the members set; until this happens, the local contact should
be in the remote-pending set. For instance, if the connection manager
queries the server to find out the initial members list for the
channel, it should leave the local contact in the remote-pending set
until it has finished receiving the initial members list.
If the protocol provides no reliable way to tell whether the complete
initial members list has been received yet, the connection manager
should make a best-effort attempt to wait for the full list
(in the worst case, waiting for a suitable arbitrary timeout)
rather than requiring user interfaces to do so on its behalf.
c C s | i i d d S( Ns1 org.freedesktop.Telepathy.Channel.Interface.Group( t _interfacest add( t self( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt __init__a s s1 org.freedesktop.Telepathy.Channel.Interface.Groupt in_signaturet aust
out_signaturet c C s
t d S( sM
Invite all the given contacts into the channel, or accept requests for
channel membership for contacts on the pending local list.
A message may be provided along with the request, which will be sent
to the server if supported. See the CHANNEL_GROUP_FLAG_MESSAGE_ADD and
CHANNEL_GROUP_FLAG_MESSAGE_ACCEPT
GroupFlags to see in which cases this
message should be provided.
Attempting to add contacts who are already members is allowed;
connection managers must silently accept this, without error.
N( t NotImplementedError( R t Contactst Message( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
AddMembersd s t auauauc C s
t d S( si
Returns arrays of all current, local and remote pending channel
members.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
GetAllMembersv s t uc C s
t d S( sF
Returns the value of the GroupFlags property.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
GetGroupFlags s t auc C s
t d S( s
If the CHANNEL_GROUP_FLAG_CHANNEL_SPECIFIC_HANDLES flag is set on
the channel, then the handles of the group members are specific
to this channel, and are not meaningful in a connection-wide
context such as contact lists. This method allows you to find
the owner of the handle if it can be discovered in this channel,
or 0 if the owner is not available.
N( R ( R t Handles( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt GetHandleOwners s c C s
t d S( s~
Returns the To_Be_Added handle (only) for each structure in the
LocalPendingMembers property.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt GetLocalPendingMembers s s a(uuus)c C s
t d S( sB
Returns the LocalPendingMembers property.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt GetLocalPendingMembersWithInfo s c C s
t d S( s6
Returns the Members property.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
GetMembers s c C s
t d S( s
Returns an array of handles representing contacts who have been
invited to the channel and are awaiting remote approval.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt GetRemotePendingMembers s c C s
t d S( sN
Returns the value of the SelfHandle
property.
N( R ( R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
GetSelfHandle s c C s
t d S( s
Requests the removal of contacts from a channel, reject their
request for channel membership on the pending local list, or
rescind their invitation on the pending remote list.
If the SelfHandle is in a Group,
it can be removed via this method, in order to leave the group
gracefully. This is the recommended way to leave a chatroom, close
or reject a StreamedMedia
call, and so on.
Accordingly, connection managers SHOULD support
doing this, regardless of the value of
GroupFlags.
If doing so fails with PermissionDenied, this is considered to a bug
in the connection manager, but clients MUST recover by falling back
to closing the channel with the Close
method.
Removing any contact from the local pending list is always
allowed. Removing contacts other than the
SelfHandle from the channel's members
is allowed if and only if Channel_Group_Flag_Can_Remove is in the
GroupFlags,
while removing contacts other than the
SelfHandle from the remote pending list
is allowed if and only if Channel_Group_Flag_Can_Rescind is in the
GroupFlags.
A message may be provided along with the request, which will be
sent to the server if supported. See the
Channel_Group_Flag_Message_Remove,
Channel_Group_Flag_Message_Depart,
Channel_Group_Flag_Message_Reject and
Channel_Group_Flag_Message_Rescind
GroupFlags to see in which cases this
message should be provided.
N( R ( R R
R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt
RemoveMembers s )t ausuc C s
t d S( s
As RemoveMembers, but a reason code may
be provided where
appropriate. The reason code may be ignored if the underlying
protocol is unable to represent the given reason.
N( R ( R R
R t Reason( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt RemoveMembersWithReason s t signatures a{uu}auc C s d S( sT
Emitted whenever the HandleOwners
property changes.
N( ( R t Addedt Removed( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt HandleOwnersChanged s c C s d S( sR
Emitted whenever the SelfHandle property
changes.
N( ( R t Self_Handle( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt SelfHandleChanged s t uuc C s d S( s
Emitted when the flags as returned by
GetGroupFlags are changed.
The user interface should be updated as appropriate.
N( ( R R R ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt GroupFlagsChanged s t sauauauauuuc C s d S( s
Emitted when contacts join any of the three lists (members, local
pending or remote pending) or when they leave any of the three lists.
There may also be a message from the server regarding this change,
which may be displayed to the user if desired.
All channel-specific handles that are mentioned in this signal
MUST be represented in the value of the
HandleOwners property.
In practice, this will mean that
HandleOwnersChanged is
emitted before emitting a MembersChanged signal in which
channel-specific handles are added, but that it is emitted
after emitting a MembersChanged signal in which
channel-specific handles are removed.
N( ( R R R R t
Local_Pendingt Remote_Pendingt ActorR ( ( sP /usr/lib/python2.6/site-packages/telepathy/_generated/Channel_Interface_Group.pyt MembersChanged s s
auauauaua{sv}c C s d S( s
Emitted when contacts join any of the three lists (members, local
pending or remote pending) or when they leave any of the three
lists. This signal provides a superset of the information provided by
MembersChanged;
if the channel's GroupFlags
contains Members_Changed_Detailed, then clients may listen exclusively
to this signal in preference to that signal.
All channel-specific handles that are mentioned in this signal
MUST be represented in the value of the
HandleOwners property. In practice,
this will mean that
HandleOwnersChanged is emitted
before emitting a MembersChangedDetailed signal in which
channel-specific handles are added, but that it is emitted
after emitting a MembersChangedDetailed signal in which
channel-specific handles are removed.
N( ( R R R R&