# class PartManager

###

Module | kparts
Namespace | KParts
Class | PartManager
Inherits | QObject

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().

### enums

- Reason { ReasonLeftClick, ReasonMidClick, ReasonRightClick, NoReason }
- SelectionPolicy { Direct, TriState }

enum details

### methods

- PartManager (parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget |

  Constructs a part manager.

  parent - The toplevel widget (window / dialog) the partmanager should monitor for activation/selection events

- PartManager (topLevel, parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  topLevel | QWidget |
  parent | QObject |

  Constructs a part manager.

  topLevel - The toplevel widget (window / dialog ) the partmanager should monitor for activation/selection events

  parent - The parent QObject.

- activationButtonMask ( )

  returns short

  See also setActivationButtonMask

- activePart ( )

  returns KParts.Part

  Returns the active part.

- activePartChanged (newPart)

  returns Nothing
  SIGNAL ("activePartChanged (Part*)")

  Argument | Type | Default
  --- | --- | ---
  newPart | KParts.Part |

  Emitted when the active part has changed.

  See also setActivePart()

- activeWidget ( )

  returns QWidget

  Returns the active widget of the current active part (see activePart ).

- addManagedTopLevelWidget (topLevel)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  topLevel | QWidget |

  Adds the topLevel widget to the list of managed toplevel widgets. 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.

- addPart (part, setActive)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |
  setActive | bool | 1

  Adds a part to the manager.

  Sets it to the active part automatically if setActive is true (default ). Behavior fix in KDE3.4: the part's widget is shown only if setActive is true, it used to be shown in all cases before.

- allowNestedParts ( )

  returns bool

  See also setAllowNestedParts

- eventFilter (obj, ev)

  returns bool

  Argument | Type | Default
  --- | --- | ---
  obj | QObject |
  ev | QEvent |

  Internal

- ignoreScrollBars ( )

  returns bool

  See also setIgnoreScrollBars

- partAdded (part)

  returns Nothing
  SIGNAL ("partAdded (Part*)")

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |

  Emitted when a new part has been added.

  See also addPart()

- partRemoved (part)

  returns Nothing
  SIGNAL ("partRemoved (Part*)")

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |

  Emitted when a part has been removed.

  See also removePart()

- parts ( )

  returns QList<KParts::Part

  Returns the list of parts being managed by the partmanager.

- reason ( )

  returns int

  Returns the reason for the last activePartChanged signal emitted.

  See also Reason

- removeManagedTopLevelWidget (topLevel)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  topLevel | QWidget |

  Removes the topLevel widget from the list of managed toplevel widgets.

  See also addManagedTopLevelWidget

- removePart (part)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |

  Removes a part from the manager (this does not delete the object) .

  Sets the active part to 0 if part is the activePart() .

- replacePart (oldPart, newPart, setActive)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  oldPart | KParts.Part |
  newPart | KParts.Part |
  setActive | bool | 1

  Replaces oldPart with newPart, and sets newPart as active if setActive is true. This is an optimised version of removePart + addPart

- selectedPart ( )

  returns KParts.Part

  Returns the current selected part.

- selectedWidget ( )

  returns QWidget

  Returns the selected widget of the current selected part (see selectedPart ).

- selectionPolicy ( )

  returns KParts::PartManager.SelectionPolicy

  Returns the current selection policy.

- setActivationButtonMask (buttonMask)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  buttonMask | short |

  Specifies which mouse buttons the partmanager should react upon. By default it reacts on all mouse buttons (LMB/MMB/RMB).

  buttonMask - a combination of Qt.ButtonState values e.g. Qt.LeftButton | Qt.MidButton

- setActiveComponent (instance)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  instance | KComponentData |

  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.

- setActivePart (part, widget)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |
  widget | QWidget | 0

  Sets the active part.

  The active part receives activation events.

  widget can be used to specify which widget was responsible for the activation. This is important if you have multiple views for a document/part , like in KOffice .

- setAllowNestedParts (allow)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  allow | bool |

  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.

- setIgnoreScrollBars (ignore)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  ignore | bool |

  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).

- setSelectedPart (part, widget)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  part | KParts.Part |
  widget | QWidget | 0

  Sets the selected part.

  The selected part receives selection events.

  widget can be used to specify which widget was responsible for the selection. This is important if you have multiple views for a document/part , like in KOffice .

- setSelectionPolicy (policy)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  policy | KParts::PartManager.SelectionPolicy |

  Sets the selection policy of the partmanager.

- slotManagedTopLevelWidgetDestroyed ( )

  returns Nothing

  Internal

- slotObjectDestroyed ( )

  returns Nothing

  Removes a part when it is destroyed.

- slotWidgetDestroyed ( )

  returns Nothing

  Internal

### enums - detail

- Reason { ReasonLeftClick, ReasonMidClick, ReasonRightClick, NoReason }

  This extends QFocusEvent.Reason with the non-focus-event reasons for partmanager to activate a part. To test for "any focusin reason", use < ReasonLeftClick NoReason usually means: explicit activation with setActivePart.

  | ReasonLeftClick | - 100 | - |
  | ReasonMidClick | - | - |
  | ReasonRightClick | - | - |
  | NoReason | - | - |

- SelectionPolicy { Direct, TriState }

  Selection policy. The default policy of a PartManager is Direct.

  | Direct | - | - |
  | TriState | - | - |