pyqt_reactive.widgets.shared.scrollable_form_mixin

Mixin for widgets that manage a ParameterFormManager with a scroll area.

Provides common functionality for scrolling to sections in the form. Used by ConfigWindow and StepParameterEditorWidget.

Classes

`ScrollTarget`(field_name, leaf_name, ...[, ...])	Resolved form navigation target.
`ScrollViewport`(content_widget, ...)	Snapshot of scroll-area geometry used to compute navigation.
`ScrollableFormMixin`()	Mixin for widgets that have: - self.scroll_area: QScrollArea containing the form - self.form_manager: ParameterFormManager with nested_managers
`ScrollableFormWindowNavigationDriver`(owner)	Field navigation driver that waits for scrollable-form layout readiness.

class pyqt_reactive.widgets.shared.scrollable_form_mixin.ScrollTarget(field_name: str, leaf_name: str, section_path: str, target_widget: QWidget, groupbox_widget: QWidget | None, current_manager: Any, is_field: bool, structural_flash_target: StructuralFlashTarget | None = None)[source]

Resolved form navigation target.

field_name: str

leaf_name: str

section_path: str

target_widget: QWidget

groupbox_widget: QWidget | None

current_manager: Any

is_field: bool

structural_flash_target: StructuralFlashTarget | None = None

__init__(field_name: str, leaf_name: str, section_path: str, target_widget: QWidget, groupbox_widget: QWidget | None, current_manager: Any, is_field: bool, structural_flash_target: StructuralFlashTarget | None = None) → None

class pyqt_reactive.widgets.shared.scrollable_form_mixin.ScrollViewport(content_widget: QWidget, viewport_height: int, viewport_top: int, viewport_bottom: int, vertical_scroll_bar: Any)[source]

Snapshot of scroll-area geometry used to compute navigation.

content_widget: QWidget

viewport_height: int

viewport_top: int

viewport_bottom: int

vertical_scroll_bar: Any

__init__(content_widget: QWidget, viewport_height: int, viewport_top: int, viewport_bottom: int, vertical_scroll_bar: Any) → None

class pyqt_reactive.widgets.shared.scrollable_form_mixin.ScrollableFormWindowNavigationDriver(owner: ScrollableFormMixin)[source]

Field navigation driver that waits for scrollable-form layout readiness.

__init__(owner: ScrollableFormMixin) → None[source]

readiness(request: RegisteredWindowNavigationRequest) → RegisteredWindowNavigationReadiness[source]

class pyqt_reactive.widgets.shared.scrollable_form_mixin.ScrollableFormMixin[source]

Mixin for widgets that have: - self.scroll_area: QScrollArea containing the form - self.form_manager: ParameterFormManager with nested_managers

Provides scroll-to-section functionality. Optionally triggers flash animation on the target groupbox.

scroll_area: QScrollArea

form_manager: ParameterFormManager

select_and_scroll_to_field(field_path: str) → None[source]

Public API for WindowManager navigation protocol.

Scrolls to and highlights the specified field. This method name matches the protocol expected by WindowManager.focus_and_navigate().

window_navigation_driver() → WindowNavigationDriver[source]: Return explicit form-field navigation behavior for WindowManager.