spinetoolbox.widgets.custom_qgraphicsscene

Custom QGraphicsScene used in the Design View.

Module Contents

Classes

CustomGraphicsScene	A custom QGraphicsScene. It provides signals to notify about items,
DesignGraphicsScene	A scene for the Design view.

class spinetoolbox.widgets.custom_qgraphicsscene.CustomGraphicsScene

Bases: PySide6.QtWidgets.QGraphicsScene

A custom QGraphicsScene. It provides signals to notify about items, and a method to center all items in the scene.

At the moment it’s used by DesignGraphicsScene and the GraphViewMixin

item_move_finished

Emitted when an item has finished moving.

center_items()

Centers toplevel items in the scene.

class spinetoolbox.widgets.custom_qgraphicsscene.DesignGraphicsScene(parent, toolbox)

Bases: CustomGraphicsScene

A scene for the Design view.

Mainly, it handles drag and drop events of ProjectItemDragMixin sources.

Parameters

• parent (QObject) – scene’s parent object

• toolbox (ToolboxUI) – reference to the main window

link_about_to_be_drawn

link_drawing_finished

clear_icons_and_links()

mouseMoveEvent(event)

Moves link drawer.

mousePressEvent(event)

Puts link drawer to sleep and logs message if it looks like the user doesn’t know what they’re doing.

mouseReleaseEvent(event)

Makes link if drawer is released over a valid connector button or cancel link drawing on right button.

_finish_link()

emit_connection_failed()

keyPressEvent(event)

Puts link drawer to sleep if user presses ESC.

connect_signals()

Connect scene signals.

project_item_icons()

handle_selection_changed()

Activates items or links based on currently selected items (or links).

set_bg_color(color)

Change background color when this is changed in Settings.

Parameters

color (QColor) – Background color

set_bg_choice(bg_choice)

Set background choice when this is changed in Settings.

Parameters

bg (str) – “grid”, “tree”, or “solid”

dragLeaveEvent(event)

Accepts event.

dragEnterEvent(event)

Accept event. Then call the super class method only if drag source is not a ProjectItemDragMixin.

dragMoveEvent(event)

Accept event. Then call the super class method only if drag source is not a ProjectItemDragMixin.

dropEvent(event)

Only accept drops when the source is an instance of ProjectItemDragMixin. Capture text from event’s mimedata and show the appropriate ‘Add Item form.’

event(event)

Accepts GraphicsSceneHelp events without doing anything, to not interfere with our usage of QToolTip.showText in graphics_items.ExclamationIcon.

drawBackground(painter, rect)

Reimplemented method to make a custom background.

Parameters

• painter (QPainter) – Painter that is used to paint background

• rect (QRectF) – The exposed (viewport) rectangle in scene coordinates

_draw_solid_bg(painter, rect)

Draws solid bg.

_draw_grid_bg(painter, rect)

Draws grid bg.

_draw_tree_bg(painter, rect)

Draws ‘tree of life’ bg.

select_link_drawer(drawer_type)

Selects current link drawer.

Parameters

drawer_type (LinkType) – selected link drawer’s type