#include <stationlistwidget.h>
Public Slots | |
void | addNewStation () |
void | deleteStation () |
void | displayStreamSettings () |
void | record () |
void | saveAllColumnSizes () |
void | stopRecord () |
Signals | |
void | multipleSelected (bool value) |
void | noneSelected (bool value) |
void | oneSelected (bool value) |
Public Member Functions | |
stationlistWidget (QWidget *parent=0, QWidget *mainWindow=0) | |
virtual | ~stationlistWidget () |
virtual bool | queryClose () |
virtual void | readProperties (const KConfigGroup &m_configGroup) |
virtual void | saveProperties (KConfigGroup &m_configGroup) |
QPointer< stationlistModel > | stationlistmodel () |
Public Attributes | |
KMenu | globalContextMenu |
KMenu | streamContextMenu |
Protected Slots | |
virtual void | selectionChanged (const QItemSelection &selected, const QItemSelection &deselected) |
Protected Member Functions | |
virtual void | contextMenuEvent (QContextMenuEvent *e) |
virtual void | mousePressEvent (QMouseEvent *event) |
Private Slots | |
void | saveColumnSize (const int column) |
Private Attributes | |
QPointer< stationlistModel > | m_stationlistModel |
This class inherits QTableView. It provides a QTableView (with nicer default values than the original) and constructs by default a stationlistModel object that is used as model.
It provides context menus. This context menus must be set up manually. See globalContextMenu and streamContextMenu.
Furthermore this class provides a number of slots, which can also be used to control the streams. You can, for example, connect KActions to this slots.
So this class handels mainly everthing that has to do with selection of rows (=streams). For all the rest, it relies on stationlistModel.
Never change the model of this view!
Make sure that you have only one object of this class at the same time.
Definition at line 49 of file stationlistwidget.h.
stationlistWidget::stationlistWidget | ( | QWidget * | parent = 0 , |
|
QWidget * | mainWindow = 0 | |||
) | [explicit] |
The constructor.
parent | The parent widget for this widget. (We can't use QPointer<QWidget> instead of QWidget * because this way we couldn't pass the argument to QTableView::QTableView() .) | |
mainWindow | Pass the mainwindow of the application here. To this window, all settings dialogs will be centered. |
Definition at line 32 of file stationlistwidget.cpp.
References stationlistModel::columnVisibility, stationlistModel::columnWidth, m_stationlistModel, and saveColumnSize().
stationlistWidget::~stationlistWidget | ( | ) | [virtual] |
The desctructor.
Definition at line 90 of file stationlistwidget.cpp.
void stationlistWidget::addNewStation | ( | ) | [slot] |
Adds a new radio station.
Definition at line 191 of file stationlistwidget.cpp.
References m_stationlistModel.
void stationlistWidget::contextMenuEvent | ( | QContextMenuEvent * | e | ) | [protected, virtual] |
Reimplemented from class QAbstractScrollArea.
Just displays globalContextMenu or streamContextMenu at the appropriate place.
Definition at line 205 of file stationlistwidget.cpp.
References globalContextMenu, and streamContextMenu.
void stationlistWidget::deleteStation | ( | ) | [slot] |
Delete the actually selected stream(s).
Definition at line 177 of file stationlistwidget.cpp.
References m_stationlistModel.
void stationlistWidget::displayStreamSettings | ( | ) | [slot] |
Displays the settings dialog for the actually selected stream.
Has only an effect if exactly one stream is selected.
Definition at line 165 of file stationlistwidget.cpp.
References m_stationlistModel.
void stationlistWidget::mousePressEvent | ( | QMouseEvent * | event | ) | [protected, virtual] |
Reimplemented from base class.
Handles middle mouse button (insert from "selection" clipboard") and forwards everthing else to the implementation of the base class.
Definition at line 237 of file stationlistwidget.cpp.
References stationlistmodel().
void stationlistWidget::multipleSelected | ( | bool | value | ) | [signal] |
This signal is emitted when the selection changes somehow and now more than one of the rows are selected.
value | is always TRUE. |
Referenced by selectionChanged().
void stationlistWidget::noneSelected | ( | bool | value | ) | [signal] |
This signal is emitted when the selection changes somehow and now none of the rows is selected.
value | is always TRUE. |
Referenced by selectionChanged().
void stationlistWidget::oneSelected | ( | bool | value | ) | [signal] |
This signal is emitted when the selection changes somehow and now exactly one of the rows is selected.
value | is always TRUE. |
Referenced by selectionChanged().
bool stationlistWidget::queryClose | ( | ) | [virtual] |
Saves some settings before the application closes.
Definition at line 220 of file stationlistwidget.cpp.
References saveAllColumnSizes(), and stationlistmodel().
void stationlistWidget::readProperties | ( | const KConfigGroup & | m_configGroup | ) | [virtual] |
Reads properties for restoring the previous session (using session management).
m_configGroup | The location where to read the properties from |
Definition at line 232 of file stationlistwidget.cpp.
References stationlistmodel().
void stationlistWidget::record | ( | ) | [slot] |
Start recording for the actually selected streams.
Definition at line 119 of file stationlistwidget.cpp.
References m_stationlistModel.
void stationlistWidget::saveAllColumnSizes | ( | ) | [slot] |
This slot saves the column sizes of the widget to the config file. This is necessary to start the next time with the column sizes with which we have left the application.
You have to call this function when the application is about to be closed. Call it in KMainWindow::queryClose()
!
We don't do this task in the destructor, because the session manager sometimes only requests for saving files (and this way calls KMainWindow::queryClose()
), and then kills the applications after a certain time. So it's better to perform this task not in the destructor, but earlier.
Definition at line 94 of file stationlistwidget.cpp.
References m_stationlistModel, NOT, saveColumnSize(), and stationlistModel::setColumnVisibility.
Referenced by queryClose(), and saveProperties().
void stationlistWidget::saveColumnSize | ( | const int | column | ) | [private, slot] |
Convenience function, that saves the column size of the given column to the config file.
Definition at line 111 of file stationlistwidget.cpp.
References m_stationlistModel, and stationlistModel::setColumnWidth.
Referenced by saveAllColumnSizes(), and stationlistWidget().
void stationlistWidget::saveProperties | ( | KConfigGroup & | m_configGroup | ) | [virtual] |
Saves properties for restoring this session later (using session management).
m_configGroup | The location where to save the properties |
Definition at line 226 of file stationlistwidget.cpp.
References saveAllColumnSizes(), and stationlistmodel().
void stationlistWidget::selectionChanged | ( | const QItemSelection & | selected, | |
const QItemSelection & | deselected | |||
) | [protected, virtual, slot] |
This reimplemented virtual function
Definition at line 145 of file stationlistwidget.cpp.
References multipleSelected(), noneSelected(), and oneSelected().
QPointer< stationlistModel > stationlistWidget::stationlistmodel | ( | ) |
Returns a pointer to the model of this view widget. Unlike model(), this function returns a pointer of type QPointer<stationlistModel>
.
Definition at line 215 of file stationlistwidget.cpp.
References m_stationlistModel.
Referenced by mousePressEvent(), queryClose(), readProperties(), and saveProperties().
void stationlistWidget::stopRecord | ( | ) | [slot] |
Stop the selected streams.
Definition at line 132 of file stationlistwidget.cpp.
References m_stationlistModel.
The context menu that is displayed when the user makes a click with the right mouse button where no item is. It is empty by default. You have to add actions to give him a function.
Definition at line 71 of file stationlistwidget.h.
Referenced by contextMenuEvent().
QPointer<stationlistModel> stationlistWidget::m_stationlistModel [private] |
A pointer to the used stationlistModel.
We could alternitivly use QTableView::model()
and than typecast to stationlistModel, but with this pointer, we have the advantage that we don't need to typecast.
Definition at line 175 of file stationlistwidget.h.
Referenced by addNewStation(), deleteStation(), displayStreamSettings(), record(), saveAllColumnSizes(), saveColumnSize(), stationlistmodel(), stationlistWidget(), and stopRecord().
The context menu that is displayed when the user makes a click with the right mouse button where an item is. It is empty by default. You have to add actions to give him a function.
Definition at line 76 of file stationlistwidget.h.
Referenced by contextMenuEvent().