spinetoolbox.widgets.custom_editors

Custom editors for model/view programming.

author:

13. Marin (KTH)

date:

2.9.2018

Module Contents

Classes

CustomLineEditor	A custom QLineEdit to handle data from models.
ParameterValueLineEditor	A custom QLineEdit to handle data from models.
CustomComboEditor	A custom QComboBox to handle data from models.
_CustomLineEditDelegate	A delegate for placing a CustomLineEditor on the first row of SearchBarEditor.
SearchBarEditor	A Google-like search bar, implemented as a QTableView with a _CustomLineEditDelegate in the first row.
CheckListEditor	A check list editor.
_IconPainterDelegate	A delegate to highlight decorations in a QListWidget.
IconColorEditor	An editor to let the user select an icon and a color for an object_class.

class spinetoolbox.widgets.custom_editors.CustomLineEditor

Bases: PySide2.QtWidgets.QLineEdit

A custom QLineEdit to handle data from models.

set_data(self, data)

data(self)

keyPressEvent(self, event)

Prevents shift key press to clear the contents.

class spinetoolbox.widgets.custom_editors.ParameterValueLineEditor

Bases: spinetoolbox.widgets.custom_editors.CustomLineEditor

A custom QLineEdit to handle data from models.

set_data(self, data)

data(self)

class spinetoolbox.widgets.custom_editors.CustomComboEditor

Bases: PySide2.QtWidgets.QComboBox

A custom QComboBox to handle data from models.

data_committed

set_data(self, current_text, items)

data(self)

class spinetoolbox.widgets.custom_editors._CustomLineEditDelegate

Bases: PySide2.QtWidgets.QItemDelegate

A delegate for placing a CustomLineEditor on the first row of SearchBarEditor.

text_edited

setModelData(self, editor, model, index)

createEditor(self, parent, option, index)

Create editor and ‘forward’ textEdited signal.

eventFilter(self, editor, event)

Handle all sort of special cases.

class spinetoolbox.widgets.custom_editors.SearchBarEditor(parent, tutor=None)

Bases: PySide2.QtWidgets.QTableView

A Google-like search bar, implemented as a QTableView with a _CustomLineEditDelegate in the first row.

Initializes instance.

Parameters:

• parent (QWidget) – parent widget
• tutor (QWidget, NoneType) – another widget used for positioning.

data_committed

set_data(self, current, items)

Populates model.

Parameters:

• current (str) –
• items (Sequence(str)) –

set_base_size(self, size)

update_geometry(self)

Updates geometry.

refit(self)

data(self)

_handle_delegate_text_edited(self, text)

Filters model as the first row is being edited.

_proxy_model_filter_accepts_row(self, source_row, source_parent)

Always accept first row.

keyPressEvent(self, event)

Sets data from current index into first index as the user navigates through the table using the up and down keys.

currentChanged(self, current, previous)

edit_first_index(self)

Edits first index if valid and not already being edited.

mouseMoveEvent(self, event)

Sets the current index to the one hovered by the mouse.

mousePressEvent(self, event)

Commits data.

class spinetoolbox.widgets.custom_editors.CheckListEditor(parent, tutor=None, ranked=False)

Bases: PySide2.QtWidgets.QTableView

A check list editor.

Initialize class.

_make_icon(self, i=None)

keyPressEvent(self, event)

Toggles checked state if the user presses space.

toggle_selected(self, index)

Adds or removes given index from selected items.

Parameters:index (QModelIndex) –

_select_item(self, qitem, rank)

_deselect_item(self, qitem, update_ranks=False)

mouseMoveEvent(self, event)

Sets the current index to the one under mouse.

mousePressEvent(self, event)

Toggles checked state of pressed index.

set_data(self, items, checked_items)

Sets data and updates geometry.

Parameters:

• items (Sequence(str)) – All items.
• checked_items (Sequence(str)) – Initially checked items.

data(self)

Returns a comma separated list of checked items.

Returns

str

set_base_size(self, size)

update_geometry(self)

Updates geometry.

class spinetoolbox.widgets.custom_editors._IconPainterDelegate

Bases: PySide2.QtWidgets.QItemDelegate

A delegate to highlight decorations in a QListWidget.

paint(self, painter, option, index)

Paints selected items using the highlight brush.

class spinetoolbox.widgets.custom_editors.IconColorEditor(parent)

Bases: PySide2.QtWidgets.QDialog

An editor to let the user select an icon and a color for an object_class.

Init class.

_proxy_model_filter_accepts_row(self, source_row, source_parent)

Overridden method to filter icons according to search terms.

connect_signals(self)

Connect signals to slots.

set_data(self, data)

data(self)