kotschak/qelectrotech-source-mirror
0
0
Fork 0
mirror of https://github.com/qelectrotech/qelectrotech-source-mirror.git synced 2026-05-15 23:40:01 +02:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Refactor comments and improve code formatting

Browse Source
This commit is contained in:
Kellermorph
2026-03-30 21:14:10 +02:00
committed by GitHub
parent 5296c1b478
commit 9149128f7a
1 changed files with 168 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

182
sources/ui/masterpropertieswidget.cpp
View File

@@ -1,20 +1,20 @@
/* /*
Copyright 2006-2026 The QElectroTech Team * Copyright 2006-2026 The QElectroTech Team
This file is part of QElectroTech. * This file is part of QElectroTech.
*
QElectroTech is free software: you can redistribute it and/or modify * QElectroTech is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by * it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or * the Free Software Foundation, either version 2 of the License, or
(at your option) any later version. * (at your option) any later version.
*
QElectroTech is distributed in the hope that it will be useful, * QElectroTech is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of * but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details. * GNU General Public License for more details.
*
You should have received a copy of the GNU General Public License * You should have received a copy of the GNU General Public License
along with QElectroTech. If not, see <http://www.gnu.org/licenses/>. * along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
*/ */
#include "masterpropertieswidget.h" #include "masterpropertieswidget.h"
#include "../diagram.h" #include "../diagram.h"
@@ -25,17 +25,18 @@
#include "ui_masterpropertieswidget.h" #include "ui_masterpropertieswidget.h"
#include <QListWidgetItem> #include <QListWidgetItem>
#include <QMessageBox>
/** /**
@brief MasterPropertiesWidget::MasterPropertiesWidget * @brief MasterPropertiesWidget::MasterPropertiesWidget
Default constructor * Default constructor
@param elmt * @param elmt
@param parent * @param parent
*/ */
MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) : MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
AbstractElementPropertiesEditorWidget(parent), AbstractElementPropertiesEditorWidget(parent),
ui(new Ui::MasterPropertiesWidget), ui(new Ui::MasterPropertiesWidget),
m_project(nullptr) m_project(nullptr)
{ {
ui->setupUi(this); ui->setupUi(this);
@@ -106,9 +107,9 @@ MasterPropertiesWidget::MasterPropertiesWidget(Element *elmt, QWidget *parent) :
} }
/** /**
@brief MasterPropertiesWidget::~MasterPropertiesWidget * @brief MasterPropertiesWidget::~MasterPropertiesWidget
Destructor * Destructor
*/ */
MasterPropertiesWidget::~MasterPropertiesWidget() MasterPropertiesWidget::~MasterPropertiesWidget()
{ {
if (m_showed_element) if (m_showed_element)
@@ -121,10 +122,10 @@ MasterPropertiesWidget::~MasterPropertiesWidget()
} }
/** /**
@brief MasterPropertiesWidget::setElement * @brief MasterPropertiesWidget::setElement
Set the element to be edited * Set the element to be edited
@param element * @param element
*/ */
void MasterPropertiesWidget::setElement(Element *element) void MasterPropertiesWidget::setElement(Element *element)
{ {
if (m_element == element) if (m_element == element)
@@ -164,13 +165,13 @@ void MasterPropertiesWidget::setElement(Element *element)
} }
/** /**
@brief MasterPropertiesWidget::apply * @brief MasterPropertiesWidget::apply
If link between edited element and other change, * If link between edited element and other change,
apply the change with a QUndoCommand (got with method associatedUndo) * apply the change with a QUndoCommand (got with method associatedUndo)
pushed to the stack of element project. * pushed to the stack of element project.
Return true if link change, else false * Return true if link change, else false
@note is void no Return ??? * @note is void no Return ???
*/ */
void MasterPropertiesWidget::apply() void MasterPropertiesWidget::apply()
{ {
if (QUndoCommand *undo = associatedUndo()) if (QUndoCommand *undo = associatedUndo())
@@ -178,9 +179,9 @@ void MasterPropertiesWidget::apply()
} }
/** /**
@brief MasterPropertiesWidget::reset * @brief MasterPropertiesWidget::reset
Reset current widget, clear eveything and rebuild widget. * Reset current widget, clear eveything and rebuild widget.
*/ */
void MasterPropertiesWidget::reset() void MasterPropertiesWidget::reset()
{ {
foreach (QTreeWidgetItem *qtwi, m_qtwi_hash.keys()) foreach (QTreeWidgetItem *qtwi, m_qtwi_hash.keys())
@@ -191,12 +192,12 @@ void MasterPropertiesWidget::reset()
} }
/** /**
@brief MasterPropertiesWidget::associatedUndo * @brief MasterPropertiesWidget::associatedUndo
If link between the edited element and other change, * If link between the edited element and other change,
return a QUndoCommand with this change. * return a QUndoCommand with this change.
If no change return nullptr. * If no change return nullptr.
@return * @return
*/ */
QUndoCommand* MasterPropertiesWidget::associatedUndo() const QUndoCommand* MasterPropertiesWidget::associatedUndo() const
{ {
QList <Element *> to_link; QList <Element *> to_link;
@@ -229,11 +230,11 @@ QUndoCommand* MasterPropertiesWidget::associatedUndo() const
} }
/** /**
@brief MasterPropertiesWidget::setLiveEdit * @brief MasterPropertiesWidget::setLiveEdit
@param live_edit = true : live edit is enable * @param live_edit = true : live edit is enable
else false : live edit is disable. * else false : live edit is disable.
@return always true because live edit is handled by this editor widget * @return always true because live edit is handled by this editor widget
*/ */
bool MasterPropertiesWidget::setLiveEdit(bool live_edit) bool MasterPropertiesWidget::setLiveEdit(bool live_edit)
{ {
m_live_edit = live_edit; m_live_edit = live_edit;
@@ -241,9 +242,9 @@ bool MasterPropertiesWidget::setLiveEdit(bool live_edit)
} }
/** /**
@brief MasterPropertiesWidget::updateUi * @brief MasterPropertiesWidget::updateUi
Build the interface of the widget * Build the interface of the widget
*/ */
void MasterPropertiesWidget::updateUi() void MasterPropertiesWidget::updateUi()
{ {
ui->m_free_tree_widget->clear(); ui->m_free_tree_widget->clear();
@@ -334,9 +335,9 @@ void MasterPropertiesWidget::updateUi()
} }
/** /**
@brief MasterPropertiesWidget::headerCustomContextMenuRequested * @brief MasterPropertiesWidget::headerCustomContextMenuRequested
@param pos * @param pos
*/ */
void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos) void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
{ {
m_context_menu->clear(); m_context_menu->clear();
@@ -344,31 +345,33 @@ void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
m_context_menu->popup(ui->m_free_tree_widget->header()->mapToGlobal(pos)); m_context_menu->popup(ui->m_free_tree_widget->header()->mapToGlobal(pos));
} }
/**
@brief MasterPropertiesWidget::on_link_button_clicked
move current item in the free_list to linked_list
*/
/** /**
* @brief MasterPropertiesWidget::on_link_button_clicked * @brief MasterPropertiesWidget::on_link_button_clicked
* move current item in the free_list to linked_list * Moves the current item from the free_list to the linked_list,
* provided the master's slave limit has not been reached.
*/ */
void MasterPropertiesWidget::on_link_button_clicked() void MasterPropertiesWidget::on_link_button_clicked()
{ {
// --- NEU: Prüfen, ob das Master-Limit im UI bereits erreicht ist --- // Get the maximum number of allowed slaves from the element's information
QVariant max_slaves_variant = m_element->kindInformations().value("max_slaves"); QVariant max_slaves_variant = m_element->kindInformations().value("max_slaves");
if (max_slaves_variant.isValid() && !max_slaves_variant.toString().isEmpty()) { if (max_slaves_variant.isValid() && !max_slaves_variant.toString().isEmpty()) {
int max_slaves = max_slaves_variant.toInt(); int max_slaves = max_slaves_variant.toInt();
int current_slaves = ui->m_link_tree_widget->topLevelItemCount();
// Wir zählen, wie viele Elemente schon in der "Verbunden"-Liste liegen // If a limit is set and reached
if (max_slaves != -1 && ui->m_link_tree_widget->topLevelItemCount() >= max_slaves) { if (max_slaves != -1 && current_slaves >= max_slaves) {
// Limit erreicht! Wir brechen die Aktion einfach ab.
// Show a message box with the actual window as parent to ensure it's on top
QMessageBox::warning(this->window(),
tr("Maximum Slaves Reached"),
tr("This master element cannot accept any new slaves because it is full (Limit: %1).").arg(max_slaves));
return; return;
} }
} }
// -------------------------------------------------------------------
//take the current item from free_list and push it to linked_list // Move current item from free_list to linked_list
QTreeWidgetItem *qtwi = ui->m_free_tree_widget->currentItem(); QTreeWidgetItem *qtwi = ui->m_free_tree_widget->currentItem();
if (qtwi) if (qtwi)
{ {
@@ -381,10 +384,11 @@ void MasterPropertiesWidget::on_link_button_clicked()
} }
} }
/** /**
@brief MasterPropertiesWidget::on_unlink_button_clicked * @brief MasterPropertiesWidget::on_unlink_button_clicked
move current item in linked_list to free_list * move current item in linked_list to free_list
*/ */
void MasterPropertiesWidget::on_unlink_button_clicked() void MasterPropertiesWidget::on_unlink_button_clicked()
{ {
//take the current item from linked_list and push it to free_list //take the current item from linked_list and push it to free_list
@@ -401,11 +405,11 @@ void MasterPropertiesWidget::on_unlink_button_clicked()
} }
/** /**
@brief MasterPropertiesWidget::showElementFromTWI * @brief MasterPropertiesWidget::showElementFromTWI
Show the element corresponding to the given QTreeWidgetItem * Show the element corresponding to the given QTreeWidgetItem
@param qtwi * @param qtwi
@param column * @param column
*/ */
void MasterPropertiesWidget::showElementFromTWI(QTreeWidgetItem *qtwi, int column) void MasterPropertiesWidget::showElementFromTWI(QTreeWidgetItem *qtwi, int column)
{ {
Q_UNUSED(column); Q_UNUSED(column);
@@ -426,19 +430,19 @@ void MasterPropertiesWidget::showElementFromTWI(QTreeWidgetItem *qtwi, int colum
} }
/** /**
@brief MasterPropertiesWidget::showedElementWasDeleted * @brief MasterPropertiesWidget::showedElementWasDeleted
Set to nullptr the current showed element when he was deleted * Set to nullptr the current showed element when he was deleted
*/ */
void MasterPropertiesWidget::showedElementWasDeleted() void MasterPropertiesWidget::showedElementWasDeleted()
{ {
m_showed_element = nullptr; m_showed_element = nullptr;
} }
/** /**
@brief MasterPropertiesWidget::diagramWasdeletedFromProject * @brief MasterPropertiesWidget::diagramWasdeletedFromProject
This slot is called when a diagram is removed from the parent project * This slot is called when a diagram is removed from the parent project
of edited element to update the content of this widget * of edited element to update the content of this widget
*/ */
void MasterPropertiesWidget::diagramWasdeletedFromProject() void MasterPropertiesWidget::diagramWasdeletedFromProject()
{ {
// We use a timer because if the removed diagram // We use a timer because if the removed diagram
@@ -449,11 +453,11 @@ void MasterPropertiesWidget::diagramWasdeletedFromProject()
} }
/** /**
@brief MasterPropertiesWidget::customContextMenu * @brief MasterPropertiesWidget::customContextMenu
Display a context menu * Display a context menu
@param pos * @param pos
@param i : the tree widget where the context menu was requested. * @param i : the tree widget where the context menu was requested.
*/ */
void MasterPropertiesWidget::customContextMenu(const QPoint &pos, int i) void MasterPropertiesWidget::customContextMenu(const QPoint &pos, int i)
{ {
// add the size of the header to display the topleft of the QMenu // add the size of the header to display the topleft of the QMenu