KDockManager Class Reference
The manager that knows all dockwidgets and handles the dock process (and member of the dockwidget class set). More...
#include <kdockwidget.h>
Inheritance diagram for KDockManager:


Signals | |
void | change () |
Signals changes of the docking state of a dockwidget. | |
void | replaceDock (KDockWidget *oldDock, KDockWidget *newDock) |
Signals a dockwidget is replaced with another one. | |
void | setDockDefaultPos (KDockWidget *) |
Signals a dockwidget without parent (toplevel) is shown. | |
Public Member Functions | |
KDockManager (QWidget *mainWindow, const char *name=0L) | |
Constructs a dockmanager. | |
virtual | ~KDockManager () |
Destructs a dockmanager. | |
void | writeConfig (KConfig *c=0L, QString group=QString::null) |
Saves the current state of the dockmanager and of all controlled widgets. | |
void | readConfig (KConfig *c=0L, QString group=QString::null) |
Like writeConfig but reads the whole stuff in. | |
void | setMainDockWidget2 (KDockWidget *) |
| |
void | writeConfig (QDomElement &base) |
Saves the current dock window layout into a DOM tree below the given element. | |
void | readConfig (QDomElement &base) |
Reads the current dock window layout from a DOM tree below the given element. | |
void | activate () |
Shows all encapsulated widgets of all controlled dockwidgets and shows all dockwidgets which are parent of a dockwidget tab group. | |
virtual bool | eventFilter (QObject *, QEvent *) |
It's more or less a method that catches several events which are interesting for the dockmanager. | |
KDockWidget * | findWidgetParentDock (QWidget *w) const |
This method finds out what a widgets' dockwidget is. | |
void | makeWidgetDockVisible (QWidget *w) |
Works like makeDockVisible() but can be called for widgets that covered by a dockwidget. | |
QPopupMenu * | dockHideShowMenu () const |
KDockWidget * | getDockWidgetFromName (const QString &dockName) |
void | setSplitterOpaqueResize (bool b=true) |
Enables opaque resizing. | |
bool | splitterOpaqueResize () const |
Returns TRUE if opaque resizing is enabled, FALSE otherwise. | |
void | setSplitterKeepSize (bool b=true) |
Try to preserve the widget's size. | |
bool | splitterKeepSize () const |
Returns TRUE if the KeepSize is enabled, FALSE otherwise. | |
void | setSplitterHighResolution (bool b=true) |
Operate the splitter with a higher resolution. | |
bool | splitterHighResolution () const |
Returns TRUE if the splitter uses the high resolution, FALSE otherwise. | |
Protected Member Functions | |
virtual void | virtual_hook (int id, void *data) |
Friends | |
class | KDockMainWindow |
Detailed Description
The manager that knows all dockwidgets and handles the dock process (and member of the dockwidget class set).More or less a helper class for the KDockWidget class set but of interest for some functionality that can be called within a KDockMainWindow or a KDockWidget .
An important feature is the ability to read or save the current state of all things concerning to dockwidgets to KConfig .
The dockmanager is also often used when a certain dockwidget or a child of such dockwidget must be found.
- Author:
- Max Judin (documentation: Falk Brettschneider).
Definition at line 834 of file kdockwidget.h.
Constructor & Destructor Documentation
|
Constructs a dockmanager. Some initialization happen:
Definition at line 1404 of file kdockwidget.cpp. References QObject::connect(), KStdAccel::name(), and QPtrList< MenuDockData >::setAutoDelete(). |
|
Destructs a dockmanager.
Definition at line 1450 of file kdockwidget.cpp. |
Member Function Documentation
|
|
|
Definition at line 1445 of file kdockwidget.cpp. Referenced by KDockMainWindow::setMainDockWidget(). |
|
Saves the current dock window layout into a DOM tree below the given element.
Definition at line 1938 of file kdockwidget.cpp. References QMainWindow::centralWidget(), QDomDocument::createElement(), KDockWidgetHeader::dragEnabled(), KDockWidget::firstName, QWidget::frameGeometry(), QString::fromLatin1(), getDockWidgetFromName(), KDockMainWindow::getMainDockWidget(), KDockWidget::header, KDockWidget::isGroup, KDockWidget::isTabGroup, QWidget::isVisible(), KDockWidget::lastName, QString::latin1(), QWidget::size(), KDockWidget::splitterOrientation, and KDockWidget::widget. |
|
Reads the current dock window layout from a DOM tree below the given element.
Definition at line 2025 of file kdockwidget.cpp. References activate(), KDockWidget::applyToWidget(), getDockWidgetFromName(), KDockWidget::header, QWidget::hide(), QString::isEmpty(), KDockWidget::isGroup, KDockWidget::isTabGroup, QWidget::isVisible(), QString::latin1(), KDockWidget::manualDock(), QWidget::move(), KStdAccel::name(), QObject::name(), QTabWidget::page(), QWidget::resize(), QMainWindow::setCentralWidget(), KDockWidgetHeader::setDragEnabled(), QWidget::setGeometry(), KDockMainWindow::setMainDockWidget(), QWidget::show(), KDockWidget::show(), QTabWidget::showPage(), QRect::size(), QDomElement::tagName(), QRect::topLeft(), KDockWidget::undock(), and KDockWidget::widget. |
|
Shows all encapsulated widgets of all controlled dockwidgets and shows all dockwidgets which are parent of a dockwidget tab group.
Definition at line 1466 of file kdockwidget.cpp. References KDockWidget::parentDockTabGroup(), KDockWidget::show(), QWidget::show(), and KDockWidget::widget. Referenced by KDockMainWindow::activateDock(), and readConfig(). |
|
It's more or less a method that catches several events which are interesting for the dockmanager. Mainly mouse events during the drag process of a dockwidgets are of interest here.
Reimplemented from QObject. Definition at line 1481 of file kdockwidget.cpp. References KDockWidget::currentDockPos, KDockWidget::dockBack(), KDockWidget::eDocking, KNotifyClient::event(), QObject::eventFilter(), QWidget::geometry(), QObject::inherits(), QWidget::mapFromGlobal(), QWidget::mapToGlobal(), QWidget::move(), QCursor::pos(), QWidget::setFocus(), and KDockWidget::toDesktop(). |
|
This method finds out what a widgets' dockwidget is. That means the dockmanager has a look at all dockwidgets it knows and tells you when one of those dockwidgets covers the given widget.
Definition at line 2500 of file kdockwidget.cpp. References KDockWidget::widget. Referenced by KDockMainWindow::makeWidgetDockVisible(). |
|
Works like makeDockVisible() but can be called for widgets that covered by a dockwidget.
Definition at line 931 of file kdockwidget.h. References KDockWidget::makeDockVisible(). |
|
Definition at line 936 of file kdockwidget.h. Referenced by KDockMainWindow::dockHideShowMenu(). |
|
Definition at line 2424 of file kdockwidget.cpp. References QString::latin1(). Referenced by readConfig(), and writeConfig(). |
|
Enables opaque resizing. Opaque resizing is initially turned off. Call this method before you create any dock widgets! Definition at line 2440 of file kdockwidget.cpp. |
|
Returns TRUE if opaque resizing is enabled, FALSE otherwise.
Definition at line 2445 of file kdockwidget.cpp. Referenced by KDockWidget::manualDock(). |
|
Try to preserve the widget's size. Works like KeepSize resize mode of QSplitter. Off by default. Call this method before you create any dock widgets! Definition at line 2450 of file kdockwidget.cpp. |
|
Returns TRUE if the KeepSize is enabled, FALSE otherwise.
Definition at line 2455 of file kdockwidget.cpp. Referenced by KDockWidget::manualDock(). |
|
Operate the splitter with a higher resolution. Off by default. Call this method before you create any dock widgets! If high resolution is used all splitter position parameters are percent*100 instead of percent. Definition at line 2460 of file kdockwidget.cpp. |
|
Returns TRUE if the splitter uses the high resolution, FALSE otherwise.
Definition at line 2465 of file kdockwidget.cpp. Referenced by KDockWidget::manualDock(). |
|
Signals changes of the docking state of a dockwidget. Usually the dock-toolbar will be updated then. Referenced by KDockWidget::event(), KDockWidget::manualDock(), and KDockWidget::undock(). |
|
Signals a dockwidget is replaced with another one.
Referenced by KDockWidget::manualDock(), and KDockWidget::undock(). |
|
Signals a dockwidget without parent (toplevel) is shown.
Referenced by KDockWidget::show(). |
The documentation for this class was generated from the following files: