# vim:set et sts=4 sw=4:

#

# ibus - The Input Bus

#

# Copyright (c) 2007-2010 Peng Huang <shawn.p.huang@gmail.com>

# Copyright (c) 2007-2010 Red Hat, Inc.

#

# 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

__all__ = ("IInputContext", )

import dbus.service

from ibus.common import \

    IBUS_IFACE_INPUT_CONTEXT

class IInputContext(dbus.service.Object):

    # define method decorator.

    method = lambda **args: \

        dbus.service.method(dbus_interface=IBUS_IFACE_INPUT_CONTEXT, \

                            **args)

    # define async method decorator.

    async_method = lambda **args: \

        dbus.service.method(dbus_interface=IBUS_IFACE_INPUT_CONTEXT, \

                            async_callbacks=("reply_cb", "error_cb"), \

                            **args)

    # define signal decorator.

    signal = lambda **args: \

        dbus.service.signal(dbus_interface=IBUS_IFACE_INPUT_CONTEXT, \

                            **args)

    @async_method(in_signature="uuu", out_signature="b")

    def ProcessKeyEvent(self, keyval, keycode, state, reply_cb, error_cb): pass

    @method(in_signature="iiii")

    def SetCursorLocation(self, x, y, w, h): pass

    @method(in_signature="vuu")

    def SetSurroundingText(self, text, cursor_index, anchor_pos): pass

    @method()

    def FocusIn(self): pass

    @method()

    def FocusOut(self): pass

    @method()

    def Reset(self): pass

    @method(in_signature="u")

    def SetCapabilities(self, caps): pass

    @method(out_signature="v")

    def GetEngine(self): pass

    @method(in_signature="s")

    def SetEngine(self, engine_name): pass

    @method()

    def Destroy(self): pass

    #sigals

    @signal(signature="v")

    def CommitText(self, text): pass

    @signal(signature="uuu")

    def ForwardKeyEvent(self, keyval, keycode, state): pass

    @signal(signature="iu")

    def DeleteSurroundingText(self, offset_from_cursor, nchars): pass

    @signal(signature="vub")

    def UpdatePreeditText(self, text, cursor_pos, visible): pass

    @signal()

    def ShowPreeditText(self): pass

    @signal()

    def HidePreeditText(self): pass

    @signal(signature="vb")

    def UpdateAuxiliaryText(self, text, visible): pass

    @signal()

    def ShowAuxiliaryText(self): pass

    @signal()

    def HideAuxiliaryText(self): pass

    @signal(signature="vb")

    def UpdateLookupTable(self, lookup_table, visible): pass

    @signal()

    def ShowLookupTable(self): pass

    @signal()

    def HideLookupTable(self): pass

    @signal()

    def PageUpLookupTable(self): pass

    @signal()

    def PageDownLookupTable(self): pass

    @signal()

    def CursorUpLookupTable(self): pass

    @signal()

    def CursorDownLookupTable(self): pass

    @signal(signature="v")

    def RegisterProperties(self, props): pass

    @signal(signature="v")

    def UpdateProperty(self, prop): pass