git.maemo.org Git - theonering/blob - src/tp/_generated/Account_Interface_Avatar.py

   1 # -*- coding: utf-8 -*-
   2 # Generated from the Telepathy spec
   3 """Copyright (C) 2008 Collabora Ltd.
   4 Copyright (C) 2008 Nokia Corporation
   5
   6 This library is free software; you can redistribute it and/or
   7 modify it under the terms of the GNU Lesser General Public
   8 License as published by the Free Software Foundation; either
   9 version 2.1 of the License, or (at your option) any later version.
  10
  11 This library is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 Lesser General Public License for more details.
  15
  16 You should have received a copy of the GNU Lesser General Public
  17 License along with this library; if not, write to the Free Software
  18 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  19
  20
  21 """
  22
  23 import dbus.service
  24
  25
  26 class AccountInterfaceAvatar(dbus.service.Interface):
  27     """\
  28       This interface extends the core Account interface to provide a
  29         user-settable avatar image.
  30
  31
  32         The avatar could have been a property on the core Account interface,
  33           but was moved to a separate interface because it is likely to be
  34           large. This means that clients can safely use GetAll to get
  35           properties on the core Account interface without flooding the
  36           session bus with large images.
  37
  38
  39     """
  40
  41     def __init__(self):
  42         self._interfaces.add('org.freedesktop.Telepathy.Account.Interface.Avatar')
  43
  44     @dbus.service.signal('org.freedesktop.Telepathy.Account.Interface.Avatar', signature='')
  45     def AvatarChanged(self):
  46         """
  47         Emitted when the Avatar property changes.
  48
  49         The avatar itself is deliberately not included in this
  50           signal, to reduce bus traffic in the (likely common) case where no
  51           running application cares about the user's own avatar.
  52
  53         """
  54         pass
  55