E5Gui/E5ToolBarDialog.py

changeset 55
b5c84934de9c
child 410
e5d1addeb90c
child 792
a13346916170
diff -r 31463df17fd5 -r b5c84934de9c E5Gui/E5ToolBarDialog.py
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/E5Gui/E5ToolBarDialog.py	Wed Jan 13 18:53:58 2010 +0000
@@ -0,0 +1,461 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2008 - 2010 Detlev Offenbach <detlev@die-offenbachs.de>
+#
+
+"""
+Module implementing a toolbar configuration dialog.
+"""
+
+from PyQt4.QtGui import *
+from PyQt4.QtCore import *
+
+from .Ui_E5ToolBarDialog import Ui_E5ToolBarDialog
+
+import UI.PixmapCache
+
+class E5ToolBarItem(object):
+    """
+    Class storing data belonging to a toolbar entry of the toolbar dialog.
+    """
+    def __init__(self, toolBarId, actionIDs, default):
+        """
+        Constructor
+        
+        @param toolBarId id of the toolbar object (integer)
+        @param actionIDs list of action IDs belonging to the toolbar (list of integer)
+        @param default flag indicating a default toolbar (boolean)
+        """
+        self.toolBarId = toolBarId
+        self.actionIDs = actionIDs[:]
+        self.isDefault = default
+        self.title = ""
+        self.isChanged = False
+    
+class E5ToolBarDialog(QDialog, Ui_E5ToolBarDialog):
+    """
+    Class implementing a toolbar configuration dialog.
+    """
+    ActionIdRole = Qt.UserRole
+    WidgetActionRole = Qt.UserRole + 1
+    
+    def __init__(self, toolBarManager, parent = None):
+        """
+        Constructor
+        
+        @param toolBarManager reference to a toolbar manager object (E5ToolBarManager)
+        @param parent reference to the parent widget (QWidget)
+        """
+        QDialog.__init__(self, parent)
+        self.setupUi(self)
+        
+        self.__manager = toolBarManager
+        self.__toolbarItems = {}    # maps toolbar item IDs to toolbar items
+        self.__currentToolBarItem = None
+        self.__removedToolBarIDs = []   # remember custom toolbars to be deleted
+        
+        self.__widgetActionToToolBarItemID = {}   # maps widget action IDs to toolbar item IDs
+        self.__toolBarItemToWidgetActionID = {} # maps toolbar item IDs to widget action IDs
+        
+        self.upButton.setIcon(UI.PixmapCache.getIcon("1uparrow.png"))
+        self.downButton.setIcon(UI.PixmapCache.getIcon("1downarrow.png"))
+        self.leftButton.setIcon(UI.PixmapCache.getIcon("1leftarrow.png"))
+        self.rightButton.setIcon(UI.PixmapCache.getIcon("1rightarrow.png"))
+        
+        self.__restoreDefaultsButton = \
+            self.buttonBox.button(QDialogButtonBox.RestoreDefaults)
+        self.__resetButton = self.buttonBox.button(QDialogButtonBox.Reset)
+        
+        self.actionsTree.header().hide()
+        self.__separatorText = self.trUtf8("--Separator--")
+        itm = QTreeWidgetItem(self.actionsTree,  [self.__separatorText])
+        self.actionsTree.setCurrentItem(itm)
+        
+        for category in sorted(self.__manager.categories()):
+            categoryItem = QTreeWidgetItem(self.actionsTree, [category])
+            for action in self.__manager.categoryActions(category):
+                item = QTreeWidgetItem(categoryItem)
+                item.setText(0, action.text())
+                item.setIcon(0, action.icon())
+                item.setTextAlignment(0, Qt.AlignLeft | Qt.AlignVCenter)
+                item.setData(0, E5ToolBarDialog.ActionIdRole, int(id(action)))
+                item.setData(0, E5ToolBarDialog.WidgetActionRole, False)
+                if self.__manager.isWidgetAction(action):
+                    item.setData(0, E5ToolBarDialog.WidgetActionRole, True)
+                    item.setData(0, Qt.TextColorRole, QColor(Qt.blue))
+                    self.__widgetActionToToolBarItemID[id(action)] = None
+            categoryItem.setExpanded(True)
+        
+        for tbID, actions in list(self.__manager.toolBarsActions().items()):
+            tb = self.__manager.toolBarById(tbID)
+            default = self.__manager.isDefaultToolBar(tb)
+            tbItem = E5ToolBarItem(tbID, [], default)
+            self.__toolbarItems[id(tbItem)] = tbItem
+            self.__toolBarItemToWidgetActionID[id(tbItem)] = []
+            actionIDs = []
+            for action in actions:
+                if action is None:
+                    actionIDs.append(None)
+                else:
+                    aID = id(action)
+                    actionIDs.append(aID)
+                    if aID in self.__widgetActionToToolBarItemID:
+                        self.__widgetActionToToolBarItemID[aID] = id(tbItem)
+                        self.__toolBarItemToWidgetActionID[id(tbItem)].append(aID)
+            tbItem.actionIDs = actionIDs
+            self.toolbarComboBox.addItem(tb.windowTitle(), int(id(tbItem)))
+            if default:
+                self.toolbarComboBox.setItemData(self.toolbarComboBox.count() - 1, 
+                    QColor(Qt.darkGreen), Qt.ForegroundRole)
+        self.toolbarComboBox.model().sort(0)
+        
+        self.connect(self.toolbarComboBox, SIGNAL("currentIndexChanged(int)"), 
+            self.__toolbarComboBox_currentIndexChanged)
+        self.toolbarComboBox.setCurrentIndex(0)
+    
+    @pyqtSlot()
+    def on_newButton_clicked(self):
+        """
+        Private slot to create a new toolbar.
+        """
+        name, ok = QInputDialog.getText(\
+            self,
+            self.trUtf8("New Toolbar"),
+            self.trUtf8("Toolbar Name:"),
+            QLineEdit.Normal)
+        if ok and name:
+            if self.toolbarComboBox.findText(name) != -1:
+                # toolbar with this name already exists
+                QMessageBox.critical(self,
+                self.trUtf8("New Toolbar"),
+                self.trUtf8("""A toolbar with the name <b>{0}</b> already exists.""")\
+                    .format(name),
+                QMessageBox.StandardButtons(\
+                    QMessageBox.Abort))
+                return
+            
+            tbItem = E5ToolBarItem(None, [], False)
+            tbItem.title = name
+            tbItem.isChanged = True
+            self.__toolbarItems[id(tbItem)] = tbItem
+            self.__toolBarItemToWidgetActionID[id(tbItem)] = []
+            self.toolbarComboBox.addItem(name, int(id(tbItem)))
+            self.toolbarComboBox.model().sort(0)
+            self.toolbarComboBox.setCurrentIndex(self.toolbarComboBox.findText(name))
+    
+    @pyqtSlot()
+    def on_removeButton_clicked(self):
+        """
+        Private slot to remove a custom toolbar
+        """
+        name = self.toolbarComboBox.currentText()
+        res = QMessageBox.question(self,
+            self.trUtf8("Remove Toolbar"),
+            self.trUtf8("""Should the toolbar <b>{0}</b> really be removed?""")\
+                .format(name),
+            QMessageBox.StandardButtons(\
+                QMessageBox.No | \
+                QMessageBox.Yes),
+            QMessageBox.No)
+        if res == QMessageBox.Yes:
+            index = self.toolbarComboBox.currentIndex()
+            tbItemID = self.toolbarComboBox.itemData(index)
+            tbItem = self.__toolbarItems[tbItemID]
+            if tbItem.toolBarId is not None and \
+               tbItem.toolBarId not in self.__removedToolBarIDs:
+                self.__removedToolBarIDs.append(tbItem.toolBarId)
+            del self.__toolbarItems[tbItemID]
+            for widgetActionID in self.__toolBarItemToWidgetActionID[tbItemID]:
+                self.__widgetActionToToolBarItemID[widgetActionID] = None
+            del self.__toolBarItemToWidgetActionID[tbItemID]
+            self.toolbarComboBox.removeItem(index)
+    
+    @pyqtSlot()
+    def on_renameButton_clicked(self):
+        """
+        Private slot to rename a custom toolbar.
+        """
+        oldName = self.toolbarComboBox.currentText()
+        newName, ok = QInputDialog.getText(\
+            self,
+            self.trUtf8("Rename Toolbar"),
+            self.trUtf8("New Toolbar Name:"),
+            QLineEdit.Normal,
+            oldName)
+        if ok and newName:
+            if oldName == newName:
+                return
+            if self.toolbarComboBox.findText(newName) != -1:
+                # toolbar with this name already exists
+                QMessageBox.critical(self,
+                self.trUtf8("Rename Toolbar"),
+                self.trUtf8("""A toolbar with the name <b>{0}</b> already exists.""")\
+                    .format(newName),
+                QMessageBox.StandardButtons(\
+                    QMessageBox.Abort))
+                return
+            index = self.toolbarComboBox.currentIndex()
+            self.toolbarComboBox.setItemText(index, newName)
+            tbItem = \
+                self.__toolbarItems[self.toolbarComboBox.itemData(index)]
+            tbItem.title = newName
+            tbItem.isChanged = True
+    
+    def __setupButtons(self):
+        """
+        Private slot to set the buttons state.
+        """
+        index = self.toolbarComboBox.currentIndex()
+        if index > -1:
+            itemID = self.toolbarComboBox.itemData(index)
+            self.__currentToolBarItem = self.__toolbarItems[itemID]
+            self.renameButton.setEnabled(not self.__currentToolBarItem.isDefault)
+            self.removeButton.setEnabled(not self.__currentToolBarItem.isDefault)
+            self.__restoreDefaultsButton.setEnabled(self.__currentToolBarItem.isDefault)
+            self.__resetButton.setEnabled(self.__currentToolBarItem.toolBarId is not None)
+        
+        row = self.toolbarActionsList.currentRow()
+        self.upButton.setEnabled(row > 0)
+        self.downButton.setEnabled(row < self.toolbarActionsList.count() - 1)
+        self.leftButton.setEnabled(self.toolbarActionsList.count() > 0)
+        rightEnable = self.actionsTree.currentItem().parent() is not None or \
+            self.actionsTree.currentItem().text(0) == self.__separatorText
+        self.rightButton.setEnabled(rightEnable)
+    
+    @pyqtSlot(int)
+    def __toolbarComboBox_currentIndexChanged(self, index):
+        """
+        Private slot called upon a selection of the current toolbar.
+        
+        @param index index of the new current toolbar (integer)
+        """
+        itemID = self.toolbarComboBox.itemData(index)
+        self.__currentToolBarItem = self.__toolbarItems[itemID]
+        self.toolbarActionsList.clear()
+        for actionID in self.__currentToolBarItem.actionIDs:
+            item = QListWidgetItem(self.toolbarActionsList)
+            if actionID is None:
+                item.setText(self.__separatorText)
+            else:
+                action = self.__manager.actionById(actionID)
+                item.setText(action.text())
+                item.setIcon(action.icon())
+                item.setTextAlignment(Qt.AlignLeft | Qt.AlignVCenter)
+                item.setData(E5ToolBarDialog.ActionIdRole, int(id(action)))
+                item.setData(E5ToolBarDialog.WidgetActionRole, False)
+                if self.__manager.isWidgetAction(action):
+                    item.setData(E5ToolBarDialog.WidgetActionRole, True)
+                    item.setData(Qt.TextColorRole, QColor(Qt.blue))
+        self.toolbarActionsList.setCurrentRow(0)
+        
+        self.__setupButtons()
+    
+    @pyqtSlot(QTreeWidgetItem, QTreeWidgetItem)
+    def on_actionsTree_currentItemChanged(self, current, previous):
+        """
+        Private slot called, when the currently selected action changes.
+        """
+        self.__setupButtons()
+    
+    @pyqtSlot(QListWidgetItem, QListWidgetItem)
+    def on_toolbarActionsList_currentItemChanged(self, current, previous):
+        """
+        Slot documentation goes here.
+        """
+        self.__setupButtons()
+    
+    @pyqtSlot()
+    def on_upButton_clicked(self):
+        """
+        Private slot used to move an action up in the list.
+        """
+        row = self.toolbarActionsList.currentRow()
+        if row == 0:
+            # we're already at the top
+            return
+        
+        actionID = self.__currentToolBarItem.actionIDs.pop(row)
+        self.__currentToolBarItem.actionIDs.insert(row - 1, actionID)
+        self.__currentToolBarItem.isChanged = True
+        itm = self.toolbarActionsList.takeItem(row)
+        self.toolbarActionsList.insertItem(row - 1, itm)
+        self.toolbarActionsList.setCurrentItem(itm)
+        self.__setupButtons()
+    
+    @pyqtSlot()
+    def on_downButton_clicked(self):
+        """
+        Private slot used to move an action down in the list.
+        """
+        row = self.toolbarActionsList.currentRow()
+        if row == self.toolbarActionsList.count() - 1:
+            # we're already at the end
+            return
+        
+        actionID = self.__currentToolBarItem.actionIDs.pop(row)
+        self.__currentToolBarItem.actionIDs.insert(row + 1, actionID)
+        self.__currentToolBarItem.isChanged = True
+        itm = self.toolbarActionsList.takeItem(row)
+        self.toolbarActionsList.insertItem(row + 1, itm)
+        self.toolbarActionsList.setCurrentItem(itm)
+        self.__setupButtons()
+    
+    @pyqtSlot()
+    def on_leftButton_clicked(self):
+        """
+        Private slot to delete an action from the list.
+        """
+        row = self.toolbarActionsList.currentRow()
+        actionID = self.__currentToolBarItem.actionIDs.pop(row)
+        self.__currentToolBarItem.isChanged = True
+        if actionID in self.__widgetActionToToolBarItemID:
+            self.__widgetActionToToolBarItemID[actionID] = None
+            self.__toolBarItemToWidgetActionID[id(self.__currentToolBarItem)]\
+                .remove(actionID)
+        itm = self.toolbarActionsList.takeItem(row)
+        del itm
+        self.toolbarActionsList.setCurrentRow(row)
+        self.__setupButtons()
+    
+    @pyqtSlot()
+    def on_rightButton_clicked(self):
+        """
+        Private slot to add an action to the list.
+        """
+        row = self.toolbarActionsList.currentRow() + 1
+            
+        item = QListWidgetItem()
+        if self.actionsTree.currentItem().text(0) == self.__separatorText:
+            item.setText(self.__separatorText)
+            actionID = None
+        else:
+            actionID = self.actionsTree.currentItem()\
+                       .data(0, E5ToolBarDialog.ActionIdRole)
+            action = self.__manager.actionById(actionID)
+            item.setText(action.text())
+            item.setIcon(action.icon())
+            item.setTextAlignment(Qt.AlignLeft | Qt.AlignVCenter)
+            item.setData(E5ToolBarDialog.ActionIdRole, int(id(action)))
+            item.setData(E5ToolBarDialog.WidgetActionRole, False)
+            if self.__manager.isWidgetAction(action):
+                item.setData(E5ToolBarDialog.WidgetActionRole, True)
+                item.setData(Qt.TextColorRole, QColor(Qt.blue))
+                oldTbItemID = self.__widgetActionToToolBarItemID[actionID]
+                if oldTbItemID is not None:
+                    self.__toolbarItems[oldTbItemID].actionIDs.remove(actionID)
+                    self.__toolbarItems[oldTbItemID].isChanged = True
+                    self.__toolBarItemToWidgetActionID[oldTbItemID].remove(actionID)
+                self.__widgetActionToToolBarItemID[actionID] = \
+                    id(self.__currentToolBarItem)
+                self.__toolBarItemToWidgetActionID[id(self.__currentToolBarItem)]\
+                    .append(actionID)
+        self.toolbarActionsList.insertItem(row, item)
+        self.__currentToolBarItem.actionIDs.insert(row, actionID)
+        self.__currentToolBarItem.isChanged = True
+        self.toolbarActionsList.setCurrentRow(row)
+        self.__setupButtons()
+    
+    @pyqtSlot(QAbstractButton)
+    def on_buttonBox_clicked(self, button):
+        """
+        Private slot called, when a button of the button box was clicked.
+        """
+        if button == self.buttonBox.button(QDialogButtonBox.Cancel):
+            self.reject()
+        elif button == self.buttonBox.button(QDialogButtonBox.Apply):
+            self.__saveToolBars()
+            self.__setupButtons()
+        elif button == self.buttonBox.button(QDialogButtonBox.Ok):
+            self.__saveToolBars()
+            self.accept()
+        elif button == self.buttonBox.button(QDialogButtonBox.Reset):
+            self.__resetCurrentToolbar()
+            self.__setupButtons()
+        elif button == self.buttonBox.button(QDialogButtonBox.RestoreDefaults):
+            self.__restoreCurrentToolbarToDefault()
+            self.__setupButtons()
+    
+    def __saveToolBars(self):
+        """
+        Private method to save the configured toolbars.
+        """
+        # step 1: remove toolbars marked for deletion
+        for tbID in self.__removedToolBarIDs:
+            tb = self.__manager.toolBarById(tbID)
+            self.__manager.deleteToolBar(tb)
+        self.__removedToolBarIDs = []
+        
+        # step 2: save configured toolbars
+        for tbItem in list(self.__toolbarItems.values()):
+            if not tbItem.isChanged:
+                continue
+            
+            if tbItem.toolBarId is None:
+                # new custom toolbar
+                tb = self.__manager.createToolBar(tbItem.title)
+                tbItem.toolBarId = id(tb)
+            else:
+                tb = self.__manager.toolBarById(tbItem.toolBarId)
+                if not tbItem.isDefault and tbItem.title:
+                    self.__manager.renameToolBar(tb, tbItem.title)
+            
+            actions = []
+            for actionID in tbItem.actionIDs:
+                if actionID is None:
+                    actions.append(None)
+                else:
+                    action = self.__manager.actionById(actionID)
+                    if action is None:
+                        raise RuntimeError("No such action, id: 0x%x" % actionID)
+                    actions.append(action)
+            self.__manager.setToolBar(tb, actions)
+            tbItem.isChanged = False
+    
+    def __restoreCurrentToolbar(self, actions):
+        """
+        Private methdo to restore the current toolbar to the given list of actions.
+        
+        @param actions list of actions to set for the current toolbar (list of QAction)
+        """
+        tbItemID = id(self.__currentToolBarItem)
+        for widgetActionID in self.__toolBarItemToWidgetActionID[tbItemID]:
+            self.__widgetActionToToolBarItemID[widgetActionID] = None
+        self.__toolBarItemToWidgetActionID[tbItemID] = []
+        self.__currentToolBarItem.actionIDs = []
+        
+        for action in actions:
+            if action is None:
+                self.__currentToolBarItem.actionIDs.append(None)
+            else:
+                actionID = id(action)
+                self.__currentToolBarItem.actionIDs.append(actionID)
+                if actionID in self.__widgetActionToToolBarItemID:
+                    oldTbItemID = self.__widgetActionToToolBarItemID[actionID]
+                    if oldTbItemID is not None:
+                        self.__toolbarItems[oldTbItemID].actionIDs.remove(actionID)
+                        self.__toolbarItems[oldTbItemID].isChanged = True
+                        self.__toolBarItemToWidgetActionID[oldTbItemID].remove(actionID)
+                    self.__widgetActionToToolBarItemID[actionID] = tbItemID
+                    self.__toolBarItemToWidgetActionID[tbItemID].append(actionID)
+        self.__toolbarComboBox_currentIndexChanged(self.toolbarComboBox.currentIndex())
+    
+    def __resetCurrentToolbar(self):
+        """
+        Private method to revert all changes made to the current toolbar.
+        """
+        tbID = self.__currentToolBarItem.toolBarId
+        actions = self.__manager.toolBarActions(tbID)
+        self.__restoreCurrentToolbar(actions)
+        self.__currentToolBarItem.isChanged = False
+    
+    def __restoreCurrentToolbarToDefault(self):
+        """
+        Private method to set the current toolbar to it's default configuration.
+        """
+        if not self.__currentToolBarItem.isDefault:
+            return
+        
+        tbID = self.__currentToolBarItem.toolBarId
+        actions = self.__manager.defaultToolBarActions(tbID)
+        self.__restoreCurrentToolbar(actions)
+        self.__currentToolBarItem.isChanged = True
\ No newline at end of file

eric ide

mercurial