Skip to content

Widget Handlers

Utilities for manipulating and managing Qt widgets.

Subpackages

Package Purpose
splitter_widgets/ Splitter management with detachable panels
stacked_widget/ QStackedWidget view caching and navigation

Available Utilities

Widget Replacement

Replace Qt Designer placeholders with custom widgets:

from src.custom_widgets.widget_handlers.set_custom_widget import replace_with_custom_widget

# Replaces placeholder, preserving size policy, constraints, object name
custom_widget = MyCustomWidget()
replace_with_custom_widget(self.ui.placeholder_widget, custom_widget)

Files

File Purpose
set_custom_widget.py Widget replacement utility

What Belongs Here

Put in widget_handlers: - Widget manipulation utilities - Layout helpers - Widget state management - Navigation utilities

Do NOT put here: - Actual widget implementations (use feedback/, calendar/, etc.) - Business logic - Data processing