summaryrefslogtreecommitdiffstats
path: root/examples/uikmdi.py
blob: 2b26dde030abcf318d743608ef547fb9f725ec51 (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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
#!/usr/bin/env python
"""
This is a rough Python translation of the ideas presented in this KMDI tutorial:

    http://web.tiscali.it/andreabergia/kmditutorial.html

What does work:

    IDEAlMode - yay!

    Adding and closing child views

    Two-way syncing between a tool widget and a matching child view

All is not rosy, however:

    Instances of the KmdiExample maintain a dictionary of child views.  Values
    cannot be deleted from this dictionary during a window close (causes an
    immediate segfault).

    Child views created after initialization aren't numbered correctly; given
    the first problem, it's harder to do this than it's really worth.

    The example segfaults at shutdown if the tool (on the left) is is open but
    is not in overlap-mode.

"""
import os
import sys

from qt import SIGNAL, TQVBoxLayout, TQLabel
from tdecore import i18n, TDEAboutData, TDEApplication, KGlobal, KIcon, TDECmdLineArgs
from tdeui import KDockWidget, KListBox, KStdAction

try:
    from kmdi import KMdi, KMdiMainFrm, KMdiChildView
except (ImportError, ):
    print 'Exception importing KMDI; check your PyKDE installation'
    sys.exit(1)


sigChildCloseRequest = SIGNAL('childWindowCloseRequest(KMdiChildView *)')
sigChildViewActivated = SIGNAL('viewActivated(KMdiChildView *)')
sigBoxSelectionChanged = SIGNAL('selectionChanged(TQListBoxItem *)')


def getIcon(name, group=KIcon.NoGroup, size=KIcon.SizeSmall):
    """ returns a kde icon by name

    """
    return KGlobal.instance().iconLoader().loadIcon(name, group, size)


class KmdiExample(KMdiMainFrm):
    """ KmdiExample(parent=None) -> an example KMdiMainFrm window

    """
    uifilebase = 'uikmdi.rc'
    viewIcons = ('network', 'email', 'stop', 'back', 'forward', )
    toolIcons = ('view_icon', 'configure')

    def __init__(self, parent=None):
        KMdiMainFrm.__init__(self, parent, 'KmdiExample', KMdi.IDEAlMode)

        xmlfile = os.path.join('.', self.uifilebase)
        self.setXMLFile(os.path.abspath(xmlfile))
        actions = self.actionCollection()
        self.openNewAction = KStdAction.openNew(self.newView, actions)
        self.quitAction = KStdAction.quit(self.close, actions)
        self.closeAction = KStdAction.close(self.closeActiveChild, actions)
        self.createGUI(None)
        self.statusBar()
        self.resize(400, 300)

        self.tools = {}
        for idx, ico in enumerate(self.toolIcons):
            wid = KListBox(self, 'list%s' % idx)
            self.makeTool(wid, 'Tool %s' % idx, ico)
        ## smells
        self.mainToolWidget = maintool = self.tools['Tool 0'][0]

        self.childs = {}
        for idx, ico in enumerate(self.viewIcons):
            self.makeView('View %s' % idx, ico, ico)


        self.connect(self, sigChildViewActivated, self.activatedMessage)
        self.connect(self, sigChildViewActivated, self.syncFromChildView)
        self.connect(maintool, sigBoxSelectionChanged, self.syncFromMainTool)
        self.syncFromChildView(self.activeWindow())


    def syncFromMainTool(self, item):
        """ activate the view that matches the item text

        """
        try:
            self.activateView(self.findWindow(item.text()))
        except (RuntimeError, ):
            pass

    def syncFromChildView(self, child):
        """ sync the main tool to the indicated child

        """
        maintool = self.mainToolWidget
        item = maintool.findItem(child.tabCaption())
        if item:
            maintool.setSelected(item, True)

    def makeTool(self, widget, caption, icon, percent=50):
        """ makes a tool from the widget

        """
        tip = i18n('%s Tool Tip' % caption)
        dock = KDockWidget.DockLeft
        maindock = self.getMainDockWidget()
        widget.setIcon(getIcon(icon))
        tool = self.addToolWindow(widget, dock, maindock, percent, tip, caption)
        self.tools[caption] = (widget, tool)

    def makeView(self, label, icon, text):
        """ makes a child view with a text label and a pixmap label

        """
        view = KMdiChildView(label, self)
        self.childs[label] = view
        view.setIcon(getIcon(icon))
        layout = TQVBoxLayout(view)
        layout.setAutoAdd(True)

        lbl = i18n('Label for a view with an icon named %s' % text)
        lbl = TQLabel(lbl, view)
        pxm = TQLabel('', view)
        pxm.setPixmap(getIcon(icon, size=KIcon.SizeLarge))

        self.addWindow(view)
        self.mainToolWidget.insertItem(label)
        self.connect(view, sigChildCloseRequest, self.closeChild)

    def removeMainToolItem(self, view):
        """ remove item from the main list tool that corresponds to the view

        """
        maintool = self.mainToolWidget
        maintool.takeItem(maintool.findItem(view.tabCaption(), 0))

    def newView(self):
        """ make a view when the user invokes the new action

        """
        self.makeView('View %s' % len(self.childs), 'network', 'A Fresh View')
        self.syncFromChildView(self.activeWindow())

    def closeActiveChild(self):
        """ close the current view

        """
        self.removeMainToolItem(self.activeWindow())
        self.closeActiveView()
        self.syncFromChildView(self.activeWindow())

    def closeChild(self, which):
        """ called to close a view from its tab close button

        """
        try:
            caption = which.tabCaption()
        except (AttributeError, ):
            ## probably None; bug in kmdi?
            return
        self.removeMainToolItem(which)
        which.close()
        self.statusBar().message(i18n('%s closed' % caption))
        self.syncFromChildView(self.activeWindow())

    def activatedMessage(self, view):
        """ updates the status bar with the caption of the current view

        """
        try:
            self.statusBar().message(i18n('%s activated' % view.tabCaption()))
        except (RuntimeError, ):
            ## sometimes the status bar or the current object is already gone...
            pass


if __name__ == '__main__':
    aname = 'PyKDE KMDI Sample'
    desc = 'A Simple PyKDE KMDI Sample'
    ver = '1.0'
    lic = TDEAboutData.License_GPL
    author = 'Troy Melhase'
    authormail = 'troy@gci.net'

    about = TDEAboutData(aname, aname, ver, desc, lic, '%s (c) 2004' % authormail)
    about.addAuthor(author, 'hi, mom!', authormail)
    about.addAuthor ('Jim Bublitz', 'For PyKDE', 'jbublitz@nwinternet.com')
    TDECmdLineArgs.init(sys.argv, about)
    app = TDEApplication()
    mainWindow = KmdiExample()
    mainWindow.show()
    app.exec_loop()