The top-level application window hosting the tab bar, menus, element palette, and editor. More...

#include <MainWindow.h>

Inheritance diagram for MainWindow:

Public Member Functions
void	createNewTab ()
	Creates a new empty circuit tab.
QDir	currentDir () const override
	Returns the directory of the currently active .panda file.
QFileInfo	currentFile () const override
	Returns the QFileInfo of the currently active .panda file.
WorkSpace *	currentTab () const override
	Returns the currently visible WorkSpace tab, or nullptr.
QString	dolphinFileName () override
	Returns the BeWavedDolphin file name associated with the current tab.
DolphinHost *	dolphinHost () override
bool	event (QEvent *event) override
void	exportToArduino (QString fileName)
	Generates Arduino sketch code for the current circuit.
void	exportToSystemVerilog (QString fileName)
	Generates SystemVerilog code for the current circuit.
void	exportToWaveFormFile (const QString &fileName)
	Saves the BeWavedDolphin waveform session to fileName.
void	exportToWaveFormTerminal ()
	Exports the current waveform simulation to standard output (terminal).
bool	hasModifiedFiles ()
	Returns true if any open workspace has unsaved changes or is a recovered autosave.
void	loadPandaFile (const QString &fileName)
	Loads a .panda circuit file into the current or a new tab.
void	loadTranslation (const QString &language)
	Loads and installs the Qt translation for language.
	MainWindow (const QString &fileName={}, QWidget *parent=nullptr)
	Constructs the MainWindow and optionally opens fileName on start.
void	openICInTab (const QString &blobName, int icElementId, const QByteArray &blob)
	Opens an embedded IC blob for editing in a new tab.
ElementPalette *	palette () const override
void	populateLanguageMenu ()
	Populates the Language submenu with available translations.
void	refreshICButtonsEnabled () override
void	requestSave () override
void	retranslateUi ()
	Re-applies all translatable strings to the UI after a language change.
void	save (const QString &fileName={}) override
	Saves the current circuit to fileName (or prompts if empty).
void	setDolphinFileName (const QString &fileName) override
	Associates fileName as the BeWavedDolphin file for the current tab.
void	setFastMode (const bool fastMode)
	Enables or disables fast (non-antialiased) rendering for all views.
void	setICButtonsVisible (bool visible) override
QString	shortcutsHelpHtml () const
void	show ()
	Shows the window and initializes child widget state.
void	showStatusMessage (const QString &message, int timeout) override
QWidget *	widget () override
	~MainWindow () override
Public Member Functions inherited from DolphinHost
virtual	~DolphinHost ()=default
Public Member Functions inherited from MainWindowHost
virtual	~MainWindowHost ()=default

Protected Member Functions
void	closeEvent (QCloseEvent *event) override

Friends
class	TestMainWindowGui

Detailed Description

The top-level application window hosting the tab bar, menus, element palette, and editor.

MainWindow orchestrates the full editing workflow: it owns the tab widget (each tab is a WorkSpace), connects undo/redo stacks, handles file open/save/export, manages translations, and integrates the element palette, element editor, and IC list panel.

Definition at line 45 of file MainWindow.h.

Constructor & Destructor Documentation

◆ MainWindow()

MainWindow::MainWindow	(	const QString &	fileName = {},
		QWidget *	parent = nullptr )

explicit

Constructs the MainWindow and optionally opens fileName on start.

Parameters

fileName	Optional .panda file to load at startup.
parent	Optional parent widget.

Definition at line 85 of file MainWindow.cpp.

References createNewTab(), AppVersion::current, currentTab(), WorkspaceManager::currentTabChanged(), Settings::fileName(), SceneUiBinder::loadFileRequested(), loadPandaFile(), WorkspaceManager::loadPandaFile(), Settings::minimapVisible(), WorkspaceManager::openICInTab(), SceneUiBinder::openICRequested(), ExerciseTourResources::preferredContentDir(), qCDebug, WorkSpace::setMinimapVisible(), and WorkspaceManager::titleChanged().

◆ ~MainWindow()

MainWindow::~MainWindow ( )

override

Definition at line 458 of file MainWindow.cpp.

Member Function Documentation

◆ closeEvent()

void MainWindow::closeEvent ( QCloseEvent * event )

overrideprotected

Reimplemented from base class.

Definition at line 670 of file MainWindow.cpp.

References event().

◆ createNewTab()

void MainWindow::createNewTab ( )

Creates a new empty circuit tab.

Definition at line 469 of file MainWindow.cpp.

Referenced by MainWindow().

◆ currentDir()

QDir MainWindow::currentDir ( ) const

overridevirtual

Returns the directory of the currently active .panda file.

Implements DolphinHost.

Definition at line 736 of file MainWindow.cpp.

◆ currentFile()

QFileInfo MainWindow::currentFile ( ) const

overridevirtual

Returns the QFileInfo of the currently active .panda file.

Implements DolphinHost.

Definition at line 726 of file MainWindow.cpp.

◆ currentTab()

WorkSpace * MainWindow::currentTab ( ) const

overridevirtual

Returns the currently visible WorkSpace tab, or nullptr.

Implements MainWindowHost.

Definition at line 783 of file MainWindow.cpp.

Referenced by main(), MainWindow(), refreshICButtonsEnabled(), and setFastMode().

◆ dolphinFileName()

QString MainWindow::dolphinFileName ( )

overridevirtual

Returns the BeWavedDolphin file name associated with the current tab.

Implements DolphinHost.

Definition at line 1276 of file MainWindow.cpp.

◆ dolphinHost()

DolphinHost * MainWindow::dolphinHost ( )

overridevirtual

Reimplemented from base class. MainWindowHost — this window's DolphinHost facet.

Implements MainWindowHost.

Definition at line 746 of file MainWindow.cpp.

◆ event()

bool MainWindow::event ( QEvent * event )

override

Reimplemented from base class.

Definition at line 1341 of file MainWindow.cpp.

References event().

Referenced by closeEvent(), and event().

◆ exportToArduino()

void MainWindow::exportToArduino ( QString fileName )

Generates Arduino sketch code for the current circuit.

Parameters

fileName Output .ino file path.

Definition at line 878 of file MainWindow.cpp.

Referenced by main().

◆ exportToSystemVerilog()

void MainWindow::exportToSystemVerilog ( QString fileName )

Generates SystemVerilog code for the current circuit.

Parameters

fileName Output .sv file path.

Definition at line 883 of file MainWindow.cpp.

◆ exportToWaveFormFile()

void MainWindow::exportToWaveFormFile ( const QString & fileName )

Saves the BeWavedDolphin waveform session to fileName.

Parameters

fileName Output .dolphin file path.

Definition at line 888 of file MainWindow.cpp.

Referenced by main().

◆ exportToWaveFormTerminal()

void MainWindow::exportToWaveFormTerminal ( )

Exports the current waveform simulation to standard output (terminal).

Definition at line 893 of file MainWindow.cpp.

Referenced by main().

◆ hasModifiedFiles()

bool MainWindow::hasModifiedFiles ( )

Returns true if any open workspace has unsaved changes or is a recovered autosave.

Definition at line 731 of file MainWindow.cpp.

◆ loadPandaFile()

void MainWindow::loadPandaFile ( const QString & fileName )

Loads a .panda circuit file into the current or a new tab.

Parameters

fileName Absolute path to the .panda file.

Definition at line 565 of file MainWindow.cpp.

Referenced by main(), and MainWindow().

◆ loadTranslation()

void MainWindow::loadTranslation ( const QString & language )

Loads and installs the Qt translation for language.

Parameters

language BCP-47 language code.

Definition at line 1038 of file MainWindow.cpp.

◆ openICInTab()

void MainWindow::openICInTab	(	const QString &	blobName,
		int	icElementId,
		const QByteArray &	blob )

Opens an embedded IC blob for editing in a new tab.

Definition at line 570 of file MainWindow.cpp.

◆ palette()

ElementPalette * MainWindow::palette ( ) const

overridevirtual

Reimplemented from base class. MainWindowHost — the element palette panel.

Implements MainWindowHost.

Definition at line 751 of file MainWindow.cpp.

◆ populateLanguageMenu()

void MainWindow::populateLanguageMenu ( )

Populates the Language submenu with available translations.

Definition at line 1043 of file MainWindow.cpp.

References Settings::language().

◆ refreshICButtonsEnabled()

void MainWindow::refreshICButtonsEnabled ( )

overridevirtual

Reimplemented from base class. MainWindowHost — re-evaluates the Add-IC button enabled state.

Implements MainWindowHost.

Definition at line 717 of file MainWindow.cpp.

References currentTab(), and WorkSpace::fileInfo().

◆ requestSave()

void MainWindow::requestSave ( )

overridevirtual

Reimplemented from base class. MainWindowHost — saves the current tab (triggers the Save action).

Implements MainWindowHost.

Definition at line 756 of file MainWindow.cpp.

◆ retranslateUi()

void MainWindow::retranslateUi ( )

Re-applies all translatable strings to the UI after a language change.

Definition at line 990 of file MainWindow.cpp.

◆ save()

void MainWindow::save ( const QString & fileName = {} )

overridevirtual

Saves the current circuit to fileName (or prompts if empty).

Parameters

fileName Absolute path; empty triggers a Save-As dialog.

Implements DolphinHost.

Definition at line 490 of file MainWindow.cpp.

◆ setDolphinFileName()

void MainWindow::setDolphinFileName ( const QString & fileName )

overridevirtual

Associates fileName as the BeWavedDolphin file for the current tab.

Parameters

fileName Path to the .dolphin file.

Implements DolphinHost.

Definition at line 1281 of file MainWindow.cpp.

◆ setFastMode()

void MainWindow::setFastMode ( const bool fastMode )

Enables or disables fast (non-antialiased) rendering for all views.

Parameters

fastMode true to use fast rendering.

Definition at line 474 of file MainWindow.cpp.

References currentTab(), GraphicsView::setFastMode(), and WorkSpace::view().

◆ setICButtonsVisible()

void MainWindow::setICButtonsVisible ( bool visible )

overridevirtual

Reimplemented from base class. MainWindowHost — shows/hides the IC management tool buttons.

Implements MainWindowHost.

Definition at line 710 of file MainWindow.cpp.

◆ shortcutsHelpHtml()

QString MainWindow::shortcutsHelpHtml ( ) const

Rich-text body of the "Shortcuts and Tips" dialog, generated from this window's actions so the list can never drift from the real key bindings and picks up any action added later. Public so GUI tests can assert its completeness without opening a modal dialog.

Definition at line 598 of file MainWindow.cpp.

◆ show()

void MainWindow::show ( )

Shows the window and initializes child widget state.

Definition at line 495 of file MainWindow.cpp.

References Application::interactiveMode, qCDebug, Settings::setWelcomeTourShown(), and Settings::welcomeTourShown().

◆ showStatusMessage()

void MainWindow::showStatusMessage	(	const QString &	message,
		int	timeout )

overridevirtual

Reimplemented from base class. MainWindowHost — shows message in the status bar for timeout ms.

Implements MainWindowHost.

Definition at line 761 of file MainWindow.cpp.

◆ widget()

QWidget * MainWindow::widget ( )

overridevirtual

Reimplemented from base class. MainWindowHost — parent widget for controller-spawned dialogs.

Implements MainWindowHost.

Definition at line 741 of file MainWindow.cpp.

◆ TestMainWindowGui

friend class TestMainWindowGui

friend

Definition at line 48 of file MainWindow.h.

References TestMainWindowGui.

Referenced by TestMainWindowGui.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ MainWindow()

◆ ~MainWindow()

Member Function Documentation

◆ closeEvent()

◆ createNewTab()

◆ currentDir()

◆ currentFile()

◆ currentTab()

◆ dolphinFileName()

◆ dolphinHost()

◆ event()

◆ exportToArduino()

◆ exportToSystemVerilog()

◆ exportToWaveFormFile()

◆ exportToWaveFormTerminal()

◆ hasModifiedFiles()

◆ loadPandaFile()

◆ loadTranslation()

◆ openICInTab()

◆ palette()

◆ populateLanguageMenu()

◆ refreshICButtonsEnabled()

◆ requestSave()

◆ retranslateUi()

◆ save()

◆ setDolphinFileName()

◆ setFastMode()

◆ setICButtonsVisible()

◆ shortcutsHelpHtml()

◆ show()

◆ showStatusMessage()

◆ widget()

Friends And Related Symbol Documentation

◆ TestMainWindowGui