diff -r 94ee489db94c -r 4ac2329b36da TimeTracker/Documentation/source/Plugin_Time_Tracker.TimeTracker.TimeTrackerWidget.html --- a/TimeTracker/Documentation/source/Plugin_Time_Tracker.TimeTracker.TimeTrackerWidget.html Thu Apr 09 18:44:42 2020 +0200 +++ b/TimeTracker/Documentation/source/Plugin_Time_Tracker.TimeTracker.TimeTrackerWidget.html Tue Jun 23 19:40:26 2020 +0200 @@ -18,260 +18,352 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>Plugin_Time_Tracker.TimeTracker.TimeTrackerWidget</h1> + <p> Module implementing the time tracker widget. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#TimeTrackerWidget">TimeTrackerWidget</a></td> <td>Class implementing the time tracker widget.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="TimeTrackerWidget" ID="TimeTrackerWidget"></a> <h2>TimeTrackerWidget</h2> + <p> Class implementing the time tracker widget. </p> <h3>Derived from</h3> QWidget, Ui_TimeTrackerWidget <h3>Class Attributes</h3> + <table> <tr><td>CommentColumn</td></tr><tr><td>DurationColumn</td></tr><tr><td>TaskColumn</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#TimeTrackerWidget.__init__">TimeTrackerWidget</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__addEntry">__addEntry</a></td> <td>Private slot to manually add an entry.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__deleteSelectedEntries">__deleteSelectedEntries</a></td> <td>Private slot to delete the selected tracker entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__editEntry">__editEntry</a></td> <td>Private slot to edit the selected tracker entry.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__exportEntries">__exportEntries</a></td> <td>Private method to export all or selected entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__exportSelectedEntries">__exportSelectedEntries</a></td> <td>Private slot to export the selected tracker entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__importEntries">__importEntries</a></td> <td>Private slot to import tracker entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__insertEntry">__insertEntry</a></td> <td>Private method to insert a tracker entry into the list.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__mergeDuplicates">__mergeDuplicates</a></td> <td>Private slot to merge duplicate entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__removeDuplicates">__removeDuplicates</a></td> <td>Private slot to remove duplicate entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__resizeColumns">__resizeColumns</a></td> <td>Private slot to resize the columns of the entries list.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.__saveEntries">__saveEntries</a></td> <td>Private slot to save the tracker entries.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.clear">clear</a></td> <td>Public method to clear all the data.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.on_commentCombo_editTextChanged">on_commentCombo_editTextChanged</a></td> <td>Private slot handling changes of the comment of the current entry.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.on_entriesList_customContextMenuRequested">on_entriesList_customContextMenuRequested</a></td> <td>Private slot to create the context menu and show it.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.on_newButton_clicked">on_newButton_clicked</a></td> <td>Private slot to end the current timer and start a new one.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.on_pauseButton_toggled">on_pauseButton_toggled</a></td> <td>Private slot to pause the current timing.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.on_taskCombo_editTextChanged">on_taskCombo_editTextChanged</a></td> <td>Private slot handling changes of the task description of the current entry.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.setCurrentEntry">setCurrentEntry</a></td> <td>Public method to set the current entry.</td> -</tr><tr> +</tr> +<tr> <td><a href="#TimeTrackerWidget.showTrackerEntries">showTrackerEntries</a></td> <td>Public method to show the tracker entries of the current project.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="TimeTrackerWidget.__init__" ID="TimeTrackerWidget.__init__"></a> <h4>TimeTrackerWidget (Constructor)</h4> <b>TimeTrackerWidget</b>(<i>tracker, parent=None</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>tracker</i></dt> <dd> reference to the time tracker (TimeTracker) -</dd><dt><i>parent</i></dt> +</dd> +<dt><i>parent</i></dt> <dd> reference to the parent widget (QWidget) </dd> -</dl><a NAME="TimeTrackerWidget.__addEntry" ID="TimeTrackerWidget.__addEntry"></a> +</dl> +<a NAME="TimeTrackerWidget.__addEntry" ID="TimeTrackerWidget.__addEntry"></a> <h4>TimeTrackerWidget.__addEntry</h4> <b>__addEntry</b>(<i></i>) + <p> Private slot to manually add an entry. -</p><a NAME="TimeTrackerWidget.__deleteSelectedEntries" ID="TimeTrackerWidget.__deleteSelectedEntries"></a> +</p> +<a NAME="TimeTrackerWidget.__deleteSelectedEntries" ID="TimeTrackerWidget.__deleteSelectedEntries"></a> <h4>TimeTrackerWidget.__deleteSelectedEntries</h4> <b>__deleteSelectedEntries</b>(<i></i>) + <p> Private slot to delete the selected tracker entries. -</p><a NAME="TimeTrackerWidget.__editEntry" ID="TimeTrackerWidget.__editEntry"></a> +</p> +<a NAME="TimeTrackerWidget.__editEntry" ID="TimeTrackerWidget.__editEntry"></a> <h4>TimeTrackerWidget.__editEntry</h4> <b>__editEntry</b>(<i></i>) + <p> Private slot to edit the selected tracker entry. -</p><a NAME="TimeTrackerWidget.__exportEntries" ID="TimeTrackerWidget.__exportEntries"></a> +</p> +<a NAME="TimeTrackerWidget.__exportEntries" ID="TimeTrackerWidget.__exportEntries"></a> <h4>TimeTrackerWidget.__exportEntries</h4> <b>__exportEntries</b>(<i>ids=None</i>) + <p> Private method to export all or selected entries. -</p><dl> +</p> +<dl> + <dt><i>ids=</i></dt> <dd> list of IDs to export or all if empty (list of integer) </dd> -</dl><a NAME="TimeTrackerWidget.__exportSelectedEntries" ID="TimeTrackerWidget.__exportSelectedEntries"></a> +</dl> +<a NAME="TimeTrackerWidget.__exportSelectedEntries" ID="TimeTrackerWidget.__exportSelectedEntries"></a> <h4>TimeTrackerWidget.__exportSelectedEntries</h4> <b>__exportSelectedEntries</b>(<i></i>) + <p> Private slot to export the selected tracker entries. -</p><a NAME="TimeTrackerWidget.__importEntries" ID="TimeTrackerWidget.__importEntries"></a> +</p> +<a NAME="TimeTrackerWidget.__importEntries" ID="TimeTrackerWidget.__importEntries"></a> <h4>TimeTrackerWidget.__importEntries</h4> <b>__importEntries</b>(<i></i>) + <p> Private slot to import tracker entries. -</p><a NAME="TimeTrackerWidget.__insertEntry" ID="TimeTrackerWidget.__insertEntry"></a> +</p> +<a NAME="TimeTrackerWidget.__insertEntry" ID="TimeTrackerWidget.__insertEntry"></a> <h4>TimeTrackerWidget.__insertEntry</h4> <b>__insertEntry</b>(<i>entry, index=-1</i>) + <p> Private method to insert a tracker entry into the list. -</p><dl> +</p> +<dl> + <dt><i>entry</i></dt> <dd> reference to the tracker entry (TimeTrackEntry) -</dd><dt><i>index</i></dt> +</dd> +<dt><i>index</i></dt> <dd> index the entry is to be inserted; -1 for at the end (integer) </dd> -</dl><a NAME="TimeTrackerWidget.__mergeDuplicates" ID="TimeTrackerWidget.__mergeDuplicates"></a> +</dl> +<a NAME="TimeTrackerWidget.__mergeDuplicates" ID="TimeTrackerWidget.__mergeDuplicates"></a> <h4>TimeTrackerWidget.__mergeDuplicates</h4> <b>__mergeDuplicates</b>(<i></i>) + <p> Private slot to merge duplicate entries. -</p><a NAME="TimeTrackerWidget.__removeDuplicates" ID="TimeTrackerWidget.__removeDuplicates"></a> +</p> +<a NAME="TimeTrackerWidget.__removeDuplicates" ID="TimeTrackerWidget.__removeDuplicates"></a> <h4>TimeTrackerWidget.__removeDuplicates</h4> <b>__removeDuplicates</b>(<i></i>) + <p> Private slot to remove duplicate entries. -</p><a NAME="TimeTrackerWidget.__resizeColumns" ID="TimeTrackerWidget.__resizeColumns"></a> +</p> +<a NAME="TimeTrackerWidget.__resizeColumns" ID="TimeTrackerWidget.__resizeColumns"></a> <h4>TimeTrackerWidget.__resizeColumns</h4> <b>__resizeColumns</b>(<i></i>) + <p> Private slot to resize the columns of the entries list. -</p><a NAME="TimeTrackerWidget.__saveEntries" ID="TimeTrackerWidget.__saveEntries"></a> +</p> +<a NAME="TimeTrackerWidget.__saveEntries" ID="TimeTrackerWidget.__saveEntries"></a> <h4>TimeTrackerWidget.__saveEntries</h4> <b>__saveEntries</b>(<i></i>) + <p> Private slot to save the tracker entries. -</p><a NAME="TimeTrackerWidget.clear" ID="TimeTrackerWidget.clear"></a> +</p> +<a NAME="TimeTrackerWidget.clear" ID="TimeTrackerWidget.clear"></a> <h4>TimeTrackerWidget.clear</h4> <b>clear</b>(<i></i>) + <p> Public method to clear all the data. -</p><a NAME="TimeTrackerWidget.on_commentCombo_editTextChanged" ID="TimeTrackerWidget.on_commentCombo_editTextChanged"></a> +</p> +<a NAME="TimeTrackerWidget.on_commentCombo_editTextChanged" ID="TimeTrackerWidget.on_commentCombo_editTextChanged"></a> <h4>TimeTrackerWidget.on_commentCombo_editTextChanged</h4> <b>on_commentCombo_editTextChanged</b>(<i>txt</i>) + <p> Private slot handling changes of the comment of the current entry. -</p><dl> +</p> +<dl> + <dt><i>txt</i></dt> <dd> new comment (string) </dd> -</dl><a NAME="TimeTrackerWidget.on_entriesList_customContextMenuRequested" ID="TimeTrackerWidget.on_entriesList_customContextMenuRequested"></a> +</dl> +<a NAME="TimeTrackerWidget.on_entriesList_customContextMenuRequested" ID="TimeTrackerWidget.on_entriesList_customContextMenuRequested"></a> <h4>TimeTrackerWidget.on_entriesList_customContextMenuRequested</h4> <b>on_entriesList_customContextMenuRequested</b>(<i>pos</i>) + <p> Private slot to create the context menu and show it. -</p><dl> +</p> +<dl> + <dt><i>pos</i></dt> <dd> position the menu should be shown at (QPoint) </dd> -</dl><a NAME="TimeTrackerWidget.on_newButton_clicked" ID="TimeTrackerWidget.on_newButton_clicked"></a> +</dl> +<a NAME="TimeTrackerWidget.on_newButton_clicked" ID="TimeTrackerWidget.on_newButton_clicked"></a> <h4>TimeTrackerWidget.on_newButton_clicked</h4> <b>on_newButton_clicked</b>(<i></i>) + <p> Private slot to end the current timer and start a new one. -</p><a NAME="TimeTrackerWidget.on_pauseButton_toggled" ID="TimeTrackerWidget.on_pauseButton_toggled"></a> +</p> +<a NAME="TimeTrackerWidget.on_pauseButton_toggled" ID="TimeTrackerWidget.on_pauseButton_toggled"></a> <h4>TimeTrackerWidget.on_pauseButton_toggled</h4> <b>on_pauseButton_toggled</b>(<i>checked</i>) + <p> Private slot to pause the current timing. -</p><dl> +</p> +<dl> + <dt><i>checked</i></dt> <dd> flag indicating the checked status of the button (boolean) </dd> -</dl><a NAME="TimeTrackerWidget.on_taskCombo_editTextChanged" ID="TimeTrackerWidget.on_taskCombo_editTextChanged"></a> +</dl> +<a NAME="TimeTrackerWidget.on_taskCombo_editTextChanged" ID="TimeTrackerWidget.on_taskCombo_editTextChanged"></a> <h4>TimeTrackerWidget.on_taskCombo_editTextChanged</h4> <b>on_taskCombo_editTextChanged</b>(<i>txt</i>) + <p> Private slot handling changes of the task description of the current entry. -</p><dl> +</p> +<dl> + <dt><i>txt</i></dt> <dd> new task description (string) </dd> -</dl><a NAME="TimeTrackerWidget.setCurrentEntry" ID="TimeTrackerWidget.setCurrentEntry"></a> +</dl> +<a NAME="TimeTrackerWidget.setCurrentEntry" ID="TimeTrackerWidget.setCurrentEntry"></a> <h4>TimeTrackerWidget.setCurrentEntry</h4> <b>setCurrentEntry</b>(<i>entry</i>) + <p> Public method to set the current entry. -</p><dl> +</p> +<dl> + <dt><i>entry</i></dt> <dd> current entry (TimeTrackEntry) </dd> -</dl><a NAME="TimeTrackerWidget.showTrackerEntries" ID="TimeTrackerWidget.showTrackerEntries"></a> +</dl> +<a NAME="TimeTrackerWidget.showTrackerEntries" ID="TimeTrackerWidget.showTrackerEntries"></a> <h4>TimeTrackerWidget.showTrackerEntries</h4> <b>showTrackerEntries</b>(<i>entries</i>) + <p> Public method to show the tracker entries of the current project. -</p><dl> +</p> +<dl> + <dt><i>entries</i></dt> <dd> list of tracker entries (list of TimeTrackEntry)