Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/addons/gtkwidgeteventfilter.py
blob: ac1439963cb1b6d147157cc14b52f901207fd26f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# Copyright (C) 2009, Tutorius.org
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program 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 General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
from ..filters import EventFilter
from ..properties import TUAMProperty, TEventType
from ..gtkutils import find_widget

class GtkWidgetEventFilter(EventFilter):
    """
    Basic Event filter for Gtk widget events
    """
    object_id = TUAMProperty()
    event_name = TEventType('clicked')

    def __init__(self, object_id=None, event_name=None):
        """Constructor
        @param object_id object fqdn-style identifier
        @param event_name event to attach to
        """
        super(GtkWidgetEventFilter,self).__init__()
        self._callback = None
        self.object_id = object_id
        self.event_name = event_name
        self._widget = None
        self._handler_id = None
    
    def install_handlers(self, callback, **kwargs):
        """install handlers
        @param callback default EventFilter callback arg
        @param activity keyword argument activity must be present to install
            the event handler into the activity's widget hierarchy
        """
        super(GtkWidgetEventFilter, self).install_handlers(callback, **kwargs)
        if not "activity" in kwargs:
            raise TypeError("activity argument is Mandatory")
        
        #find the widget and connect to its event
        self._widget = find_widget(kwargs["activity"], self.object_id)
        self._handler_id = self._widget.connect( \
                        self.event_name, self.do_callback )

    def remove_handlers(self):
        """remove handlers"""
        super(GtkWidgetEventFilter, self).remove_handlers()
        #if an event was connected, disconnect it
        if self._handler_id:
            self._widget.handler_disconnect(self._handler_id)
            self._handler_id=None

__event__ = {
    "name" : "GtkWidgetEventFilter",
    "display_name" : "GTK Event catcher",
    "icon" : "player_play",
    "class" : GtkWidgetEventFilter,
    "mandatory_props" : ["object_id", "event_name"],
}