KParts::PartManager Class Reference
The part manager is an object which knows about a collection of parts (even nested ones) and handles activation/deactivation. More...
#include <partmanager.h>
Inheritance diagram for KParts::PartManager:

Public Types | |
enum | SelectionPolicy { Direct, TriState } |
Signals | |
void | partAdded (KParts::Part *part) |
void | partRemoved (KParts::Part *part) |
void | activePartChanged (KParts::Part *newPart) |
Public Member Functions | |
PartManager (QWidget *parent, const char *name=0L) | |
PartManager (QWidget *topLevel, QObject *parent, const char *name=0) | |
void | setSelectionPolicy (SelectionPolicy policy) |
SelectionPolicy | selectionPolicy () const |
void | setAllowNestedParts (bool allow) |
bool | allowNestedParts () const |
void | setIgnoreScrollBars (bool ignore) |
bool | ignoreScrollBars () const |
void | setActivationButtonMask (short int buttonMask) |
short int | activationButtonMask () const |
virtual bool | eventFilter (QObject *obj, QEvent *ev) |
virtual void | addPart (Part *part, bool setActive=true) |
virtual void | removePart (Part *part) |
virtual void | replacePart (Part *oldPart, Part *newPart, bool setActive=true) |
virtual void | setActivePart (Part *part, QWidget *widget=0L) |
virtual Part * | activePart () const |
virtual QWidget * | activeWidget () const |
virtual void | setSelectedPart (Part *part, QWidget *widget=0L) |
virtual Part * | selectedPart () const |
virtual QWidget * | selectedWidget () const |
const QPtrList< Part > * | parts () const |
void | addManagedTopLevelWidget (const QWidget *topLevel) |
void | removeManagedTopLevelWidget (const QWidget *topLevel) |
Protected Slots | |
void | slotObjectDestroyed () |
void | slotWidgetDestroyed () |
void | slotManagedTopLevelWidgetDestroyed () |
Protected Member Functions | |
virtual void | setActiveInstance (KInstance *instance) |
virtual void | virtual_hook (int id, void *data) |
Properties | |
SelectionPolicy | selectionPolicy |
bool | allowNestedParts |
bool | ignoreScrollBars |
Detailed Description
The part manager is an object which knows about a collection of parts (even nested ones) and handles activation/deactivation.Applications that want to embed parts without merging GUIs only use a KParts::PartManager. Those who want to merge GUIs use a KParts::MainWindow for example, in addition to a part manager.
Parts know about the part manager to add nested parts to it. See also KParts::Part::manager() and KParts::Part::setManager().
Definition at line 47 of file partmanager.h.
Constructor & Destructor Documentation
|
Constructs a part manager.
Definition at line 72 of file partmanager.cpp. References addManagedTopLevelWidget(). |
|
Constructs a part manager.
Definition at line 84 of file partmanager.cpp. References addManagedTopLevelWidget(). |
Member Function Documentation
|
Sets the selection policy of the partmanager.
Definition at line 111 of file partmanager.cpp. |
|
Returns the current selection policy.
|
|
Specifies whether the partmanager should handle/allow nested parts or not. This is a property the shell has to set/specify. Per default we assume that the shell cannot handle nested parts. However in case of a KOffice shell for example we allow nested parts. A Part is nested (a child part) if its parent object inherits KParts::Part. If a child part is activated and nested parts are not allowed/handled, then the top parent part in the tree is activated. Definition at line 121 of file partmanager.cpp. |
|
|
|
Specifies whether the partmanager should ignore mouse click events for scrollbars or not. If the partmanager ignores them, then clicking on the scrollbars of a non-active/non-selected part will not change the selection or activation state. The default value is false (read: scrollbars are NOT ignored). Definition at line 131 of file partmanager.cpp. |
|
|
|
Specifies which mouse buttons the partmanager should react upon. By default it reacts on all mouse buttons (LMB/MMB/RMB).
Definition at line 141 of file partmanager.cpp. |
|
Definition at line 146 of file partmanager.cpp. |
|
Adds a part to the manager.
Sets it to the active part automatically if Definition at line 300 of file partmanager.cpp. References endl(), QWidget::focusPolicy(), kdWarning(), QObject::name(), partAdded(), setActivePart(), QWidget::setFocus(), KParts::Part::setManager(), QWidget::show(), and KParts::Part::widget(). Referenced by replacePart(). |
|
Removes a part from the manager (this does not delete the object) .
Sets the active part to 0 if Definition at line 331 of file partmanager.cpp. References endl(), kdFatal(), QObject::name(), partRemoved(), setActivePart(), KParts::Part::setManager(), and setSelectedPart(). Referenced by slotObjectDestroyed(), and KParts::Part::~Part(). |
|
Replaces This is an optimised version of removePart + addPart Definition at line 352 of file partmanager.cpp. References addPart(), endl(), kdFatal(), QObject::name(), partRemoved(), and KParts::Part::setManager(). |
|
Sets the active part. The active part receives activation events.
Definition at line 370 of file partmanager.cpp. References activePartChanged(), QObject::destroyed(), endl(), QObject::inherits(), kdDebug(), kdWarning(), QObject::name(), QObject::parent(), setActiveInstance(), setActivePart(), setSelectedPart(), and KParts::Part::widget(). Referenced by addPart(), removePart(), and setActivePart(). |
|
Returns the active part.
Definition at line 452 of file partmanager.cpp. |
|
Returns the active widget of the current active part (see activePart ).
Definition at line 457 of file partmanager.cpp. |
|
Sets the selected part. The selected part receives selection events.
Definition at line 462 of file partmanager.cpp. References KParts::Part::widget(). Referenced by removePart(), and setActivePart(). |
|
Returns the current selected part.
Definition at line 491 of file partmanager.cpp. |
|
Returns the selected widget of the current selected part (see selectedPart ).
Definition at line 496 of file partmanager.cpp. |
|
Returns the list of parts being managed by the partmanager.
Definition at line 515 of file partmanager.cpp. |
|
Adds the Usually a PartManager only listens for events (for activation/selection) for one toplevel widget (and its children) , the one specified in the constructor. Sometimes however (like for example when using the KDE dockwidget library) , it is necessary to extend this. Definition at line 520 of file partmanager.cpp. References QObject::destroyed(), and QWidget::isTopLevel(). Referenced by PartManager(). |
|
Removes the
Definition at line 533 of file partmanager.cpp. References QWidget::isTopLevel(). |
|
Emitted when a new part has been added.
Referenced by addPart(). |
|
Emitted when a part has been removed.
Referenced by removePart(), and replacePart(). |
|
Emitted when the active part has changed.
Referenced by setActivePart(). |
|
Changes the active instance when the active part changes. The active instance is used by KBugReport and KAboutDialog. Override if you really need to - usually you don't need to. Definition at line 446 of file partmanager.cpp. Referenced by setActivePart(). |
|
Removes a part when it is destroyed.
Definition at line 501 of file partmanager.cpp. References endl(), kdDebug(), removePart(), and QObject::sender(). |
The documentation for this class was generated from the following files: