magscope.ui.panel_layout

Shared helpers for draggable control panel layouts.

Attributes

PANEL_MIME_TYPE

Classes

_TitleDragFilter	Convert title-area drags into wrapper move operations.
PanelWrapper	Wrap a panel widget and make its title initiate drag-and-drop.
ReorderableColumn	Vertical column of draggable panels with drop support.
PanelLayoutManager	Coordinate draggable panel columns and persist their layout.

Module Contents

magscope.ui.panel_layout.PANEL_MIME_TYPE = 'application/x-magscope-panel'

class magscope.ui.panel_layout._TitleDragFilter(wrapper: PanelWrapper, target: PyQt6.QtWidgets.QWidget)

Bases: PyQt6.QtCore.QObject

Convert title-area drags into wrapper move operations.

_wrapper

target

_drag_start

_dragging = False

eventFilter(obj, event)

drag_finished() → None

class magscope.ui.panel_layout.PanelWrapper(manager: PanelLayoutManager, panel_id: str, widget: PyQt6.QtWidgets.QWidget, *, draggable: bool = True)

Bases: PyQt6.QtWidgets.QFrame

Wrap a panel widget and make its title initiate drag-and-drop.

_manager

panel_id

panel_widget

column: ReorderableColumn | None = None

_drag_filters: list[_TitleDragFilter] = []

draggable = True

_drop_accepted = False

_attach_title_drag() → None

_register_drag_source(widget: PyQt6.QtWidgets.QWidget | None) → None

start_drag() → None

mark_drop_accepted() → None

class magscope.ui.panel_layout.ReorderableColumn(name: str, pinned_ids: Iterable[str] | None = None)

Bases: PyQt6.QtWidgets.QWidget

Vertical column of draggable panels with drop support.

name

_layout

_placeholder: PyQt6.QtWidgets.QFrame | None = None

_pinned_ids

_active_drag_height: int | None = None

_manager: PanelLayoutManager | None = None

set_manager(manager: PanelLayoutManager | None) → None

panels() → list[PanelWrapper]

panel_ids() → list[str]

add_panel(wrapper: PanelWrapper, index: int | None = None) → None

remove_panel(wrapper: PanelWrapper) → None

clear_panels() → None

begin_drag(wrapper: PanelWrapper) → int

cancel_drag(wrapper: PanelWrapper, index: int) → None

finish_drag() → None

_target_index(index: int | None) → int

_drop_index(cursor_y: float) → int

_locked_prefix_length() → int

_constrain_index(wrapper: PanelWrapper, index: int) → int

_constrained_drop_index(wrapper: PanelWrapper, cursor_y: float) → int

_ensure_placeholder() → PyQt6.QtWidgets.QFrame

_update_placeholder(wrapper: PanelWrapper | None, cursor_y: float) → None

clear_placeholder() → None

_placeholder_index() → int | None

dragEnterEvent(event) → None

dragMoveEvent(event) → None

dragLeaveEvent(event) → None

dropEvent(event) → None

_wrapper_from_event(event) → PanelWrapper | None

class magscope.ui.panel_layout.PanelLayoutManager(settings: QSettings | None, settings_group: str, columns: dict[str, ReorderableColumn] | Iterable[tuple[str, ReorderableColumn]], *, on_layout_changed: Callable[[dict[str, list[str]]], None] | None = None, on_drag_active_changed: Callable[[bool], None] | None = None)

Coordinate draggable panel columns and persist their layout.

_settings: PyQt6.QtCore.QSettings | None

_settings_group

_wrappers: dict[str, PanelWrapper]

_default_columns: dict[str, str]

_default_order: list[str] = []

_on_layout_changed = None

_on_drag_active_changed = None

_active_drag_count = 0

wrapper_for_id(panel_id: str) → PanelWrapper | None

register_panel(panel_id: str, widget: PyQt6.QtWidgets.QWidget, default_column: str, *, draggable: bool = True) → PanelWrapper

restore_layout() → None

save_layout() → None

current_layout() → dict[str, list[str]]

layout_changed() → None

notify_drag_started() → None

notify_drag_finished() → None

_normalise_panel_list(stored) → list[str] | None

_load_layout() → OrderedDict[str, list[str]]

stored_layout() → OrderedDict[str, list[str]]

stored_column_names() → list[str]

add_column(name: str, column: ReorderableColumn, index: int | None = None) → None

remove_column(name: str) → None