diff -r 000000000000 -r de9c2efb9d02 Helpviewer/History/HistoryModel.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Helpviewer/History/HistoryModel.py Mon Dec 28 16:03:33 2009 +0000 @@ -0,0 +1,170 @@ +# -*- coding: utf-8 -*- + +# Copyright (c) 2009 Detlev Offenbach <detlev@die-offenbachs.de> +# + +""" +Module implementing the history model. +""" + +from PyQt4.QtCore import * + +import Helpviewer.HelpWindow + +class HistoryModel(QAbstractTableModel): + """ + Class implementing the history model. + """ + DateRole = Qt.UserRole + 1 + DateTimeRole = Qt.UserRole + 2 + UrlRole = Qt.UserRole + 3 + UrlStringRole = Qt.UserRole + 4 + TitleRole = Qt.UserRole + 5 + MaxRole = TitleRole + + def __init__(self, historyManager, parent = None): + """ + Constructor + + @param historyManager reference to the history manager object (HistoryManager) + @param parent reference to the parent object (QObject) + """ + QAbstractTableModel.__init__(self, parent) + + self.__historyManager = historyManager + + self.__headers = [ + self.trUtf8("Title"), + self.trUtf8("Address"), + ] + + self.connect(self.__historyManager, SIGNAL("historyReset()"), + self.historyReset) + self.connect(self.__historyManager, SIGNAL("entryRemoved"), + self.historyReset) + self.connect(self.__historyManager, SIGNAL("entryAdded"), + self.entryAdded) + self.connect(self.__historyManager, SIGNAL("entryUpdated(int)"), + self.entryUpdated) + + def historyReset(self): + """ + Public slot to reset the model. + """ + self.reset() + + def entryAdded(self): + """ + Public slot to handle the addition of a history entry. + """ + self.beginInsertRows(QModelIndex(), 0, 0) + self.endInsertRows() + + def entryUpdated(self, row): + """ + Public slot to handle the update of a history entry. + + @param row row number of the updated entry (integer) + """ + idx = self.index(row, 0) + self.emit(SIGNAL("dataChanged(const QModelIndex&, const QModelIndex&)"), + idx, idx) + + def headerData(self, section, orientation, role = Qt.DisplayRole): + """ + Public method to get the header data. + + @param section section number (integer) + @param orientation header orientation (Qt.Orientation) + @param role data role (integer) + @return header data (QVariant) + """ + if orientation == Qt.Horizontal and role == Qt.DisplayRole: + try: + return QVariant(self.__headers[section]) + except IndexError: + pass + return QAbstractTableModel.headerData(self, section, orientation, role) + + def data(self, index, role = Qt.DisplayRole): + """ + Public method to get data from the model. + + @param index index of history entry to get data for (QModelIndex) + @param role data role (integer) + @return history entry data (QVariant) + """ + lst = self.__historyManager.history() + if index.row() < 0 or index.row() > len(lst): + return QVariant() + + itm = lst[index.row()] + if role == self.DateTimeRole: + return QVariant(itm.dateTime) + elif role == self.DateRole: + return QVariant(itm.dateTime.date()) + elif role == self.UrlRole: + return QVariant(QUrl(itm.url)) + elif role == self.UrlStringRole: + return QVariant(itm.url) + elif role == self.TitleRole: + return QVariant(itm.userTitle()) + elif role in [Qt.DisplayRole, Qt.EditRole]: + if index.column() == 0: + return QVariant(itm.userTitle()) + elif index.column() == 1: + return QVariant(itm.url) + elif role == Qt.DecorationRole: + if index.column() == 0: + return QVariant(Helpviewer.HelpWindow.HelpWindow.icon(QUrl(itm.url))) + + return QVariant() + + def columnCount(self, parent = QModelIndex()): + """ + Public method to get the number of columns. + + @param parent index of parent (QModelIndex) + @return number of columns (integer) + """ + if parent.isValid(): + return 0 + else: + return len(self.__headers) + + def rowCount(self, parent = QModelIndex()): + """ + Public method to determine the number of rows. + + @param parent index of parent (QModelIndex) + @return number of rows (integer) + """ + if parent.isValid(): + return 0 + else: + return len(self.__historyManager.history()) + + def removeRows(self, row, count, parent = QModelIndex()): + """ + Public method to remove history entries from the model. + + @param row row of the first history entry to remove (integer) + @param count number of history entries to remove (integer) + @param index of the parent entry (QModelIndex) + @return flag indicating successful removal (boolean) + """ + if parent.isValid(): + return False + + lastRow = row + count - 1 + self.beginRemoveRows(parent, row, lastRow) + lst = self.__historyManager.history()[:] + for index in range(lastRow, row - 1, -1): + del lst[index] + self.disconnect(self.__historyManager, SIGNAL("historyReset()"), + self.historyReset) + self.__historyManager.setHistory(lst) + self.connect(self.__historyManager, SIGNAL("historyReset()"), + self.historyReset) + self.endRemoveRows() + return True