eric: comparison src/eric7/WebBrowser/History/HistoryMenu.py

-:c712d09cc839
+:f6881d10e995
 def __init__(self, sourceModel, parent=None):
 """
 Constructor
-@param sourceModel reference to the source model (QAbstractItemModel)
+@param sourceModel reference to the source model
-@param parent reference to the parent object (QObject)
+@type QAbstractItemModel
+@param parent reference to the parent object
+@type QObject
 """
 super().__init__(parent)
 self.__treeModel = sourceModel
 def bumpedRows(self):
 """
 Public method to determine the number of rows moved to the root.
-@return number of rows moved to the root (integer)
+@return number of rows moved to the root
+@rtype int
 """
 first = self.__treeModel.index(0, 0)
 if not first.isValid():
 return 0
 return min(self.__treeModel.rowCount(first), self.MOVEDROWS)
 def columnCount(self, parent=None):
 """
 Public method to get the number of columns.
-@param parent index of parent (QModelIndex)
+@param parent index of parent
-@return number of columns (integer)
+@type QModelIndex
+@return number of columns
+@rtype int
 """
 if parent is None:
 parent = QModelIndex()
 return self.__treeModel.columnCount(self.mapToSource(parent))
 def rowCount(self, parent=None):
 """
 Public method to determine the number of rows.
-@param parent index of parent (QModelIndex)
+@param parent index of parent
-@return number of rows (integer)
+@type QModelIndex
+@return number of rows
+@rtype int
 """
 if parent is None:
 parent = QModelIndex()
 if parent.column() > 0:
 def mapFromSource(self, sourceIndex):
 """
 Public method to map an index to the proxy model index.
-@param sourceIndex reference to a source model index (QModelIndex)
+@param sourceIndex reference to a source model index
-@return proxy model index (QModelIndex)
+@type QModelIndex
+@return proxy model index
+@rtype QModelIndex
 """
 sourceRow = self.__treeModel.mapToSource(sourceIndex).row()
 return self.createIndex(sourceIndex.row(), sourceIndex.column(), sourceRow)
 def mapToSource(self, proxyIndex):
 """
 Public method to map an index to the source model index.
-@param proxyIndex reference to a proxy model index (QModelIndex)
+@param proxyIndex reference to a proxy model index
-@return source model index (QModelIndex)
+@type QModelIndex
+@return source model index
+@rtype QModelIndex
 """
 if not proxyIndex.isValid():
 return QModelIndex()
 if proxyIndex.internalId() == sys.maxsize:
 def index(self, row, column, parent=None):
 """
 Public method to create an index.
-@param row row number for the index (integer)
+@param row row number for the index
-@param column column number for the index (integer)
+@type int
-@param parent index of the parent item (QModelIndex)
+@param column column number for the index
-@return requested index (QModelIndex)
+@type int
+@param parent index of the parent item
+@type QModelIndex
+@return requested index
+@rtype QModelIndex
 """
 if parent is None:
 parent = QModelIndex()
 if (
 def parent(self, index):
 """
 Public method to get the parent index.
-@param index index of item to get parent (QModelIndex)
+@param index index of item to get parent
-@return index of parent (QModelIndex)
+@type QModelIndex
+@return index of parent
+@rtype QModelIndex
 """
 offset = index.internalId()
 if offset == sys.maxsize or not index.isValid():
 return QModelIndex()
 def mimeData(self, indexes):
 """
 Public method to return the mime data.
-@param indexes list of indexes (QModelIndexList)
+@param indexes list of indexes
-@return mime data (QMimeData)
+@type QModelIndexList
+@return mime data
+@rtype QMimeData
 """
 urls = []
 for index in indexes:
 url = index.data(HistoryModel.UrlRole)
 urls.append(url)
 def __init__(self, sourceModel, parent=None):
 """
 Constructor
-@param sourceModel reference to the source model (QAbstractItemModel)
+@param sourceModel reference to the source model
-@param parent reference to the parent object (QObject)
+@type QAbstractItemModel
+@param parent reference to the parent object
+@type QObject
 """
 super().__init__(parent)
 self.setDynamicSortFilter(True)
 self.setSourceModel(sourceModel)
 def lessThan(self, left, right):
 """
 Public method used to sort the displayed items.
-@param left index of left item (QModelIndex)
+@param left index of left item
-@param right index of right item (QModelIndex)
+@type QModelIndex
-@return true, if left is less than right (boolean)
+@param right index of right item
+@type QModelIndex
+@return true, if left is less than right
+@rtype bool
 """
 from .HistoryFilterModel import HistoryFilterModel
 frequency_L = self.sourceModel().data(left, HistoryFilterModel.FrequencyRole)
 dateTime_L = self.sourceModel().data(left, HistoryModel.DateTimeRole)
 def __init__(self, parent=None, tabWidget=None):
 """
 Constructor
-@param parent reference to the parent widget (QWidget)
+@param parent reference to the parent widget
+@type QWidget
 @param tabWidget reference to the tab widget managing the browser
-tabs (HelpTabWidget
+tabs
+@type WebBrowserTabWidget
 """
 EricModelMenu.__init__(self, parent)
 self.__tabWidget = tabWidget
 self.__mw = parent
 def __activated(self, idx):
 """
 Private slot handling the activated signal.
-@param idx index of the activated item (QModelIndex)
+@param idx index of the activated item
+@type QModelIndex
 """
 if self._keyboardModifiers & Qt.KeyboardModifier.ControlModifier:
 self.newTab.emit(
 idx.data(HistoryModel.UrlRole), idx.data(HistoryModel.TitleRole)
 )
 def prePopulated(self):
 """
 Public method to add any actions before the tree.
-@return flag indicating if any actions were added (boolean)
+@return flag indicating if any actions were added
+@rtype bool
 """
 if self.__historyManager is None:
 self.__historyManager = WebBrowserWindow.historyManager()
 self.__historyMenuModel = HistoryMenuModel(
 self.__historyManager.historyTreeModel(), self
 def setInitialActions(self, actions):
 """
 Public method to set the list of actions that should appear first in
 the menu.
-@param actions list of initial actions (list of QAction)
+@param actions list of initial actions
+@type list of QAction
 """
 self.__initialActions = actions[:]
 for act in self.__initialActions:
 self.addAction(act)
 def __closedTabAvailable(self, avail):
 """
 Private slot to handle changes of the availability of closed tabs.
-@param avail flag indicating the availability of closed tabs (boolean)
+@param avail flag indicating the availability of closed tabs
+@type bool
 """
 self.__closedTabsMenu.setEnabled(avail)
 class HistoryMostVisitedMenu(EricModelMenu):
 def __init__(self, count, parent=None):
 """
 Constructor
-@param count maximum number of entries to be shown (integer)
+@param count maximum number of entries to be shown
-@param parent reference to the parent widget (QWidget)
+@type int
+@param parent reference to the parent widget
+@type QWidget
 """
 EricModelMenu.__init__(self, parent)
 self.__historyMenuModel = None
 def __activated(self, idx):
 """
 Private slot handling the activated signal.
-@param idx index of the activated item (QModelIndex)
+@param idx index of the activated item
+@type QModelIndex
 """
 if self._keyboardModifiers & Qt.KeyboardModifier.ControlModifier:
 self.newTab.emit(
 idx.data(HistoryModel.UrlRole), idx.data(HistoryModel.TitleRole)
 )
 def prePopulated(self):
 """
 Public method to add any actions before the tree.
-@return flag indicating if any actions were added (boolean)
+@return flag indicating if any actions were added
+@rtype bool
 """
 if self.__historyMenuModel is None:
 historyManager = WebBrowserWindow.historyManager()
 self.__historyMenuModel = HistoryMostVisitedMenuModel(
 historyManager.historyFilterModel(), self

Mercurial Repositories > eric / file comparison

comparison: src/eric7/WebBrowser/History/HistoryMenu.py

src/eric7/WebBrowser/History/HistoryMenu.py