kotschak/qelectrotech-source-mirror
0
0
Fork 0
mirror of https://github.com/qelectrotech/qelectrotech-source-mirror.git synced 2025-12-17 20:50:34 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

Mod doc set style de same

Browse Source
This commit is contained in:
Simon De Backer
2020-07-19 13:58:08 +02:00
parent 102629b86f
commit 4cd69a2450
2 changed files with 82 additions and 68 deletions
Download Patch File Download Diff File Expand all files Collapse all files

133
sources/ui/masterpropertieswidget.cpp
View File

@@ -25,11 +25,11 @@
#include <linkelementcommand.h> #include <linkelementcommand.h>
/** /**
* @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),
@@ -90,9 +90,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)
@@ -105,10 +105,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)
@@ -133,7 +133,7 @@ void MasterPropertiesWidget::setElement(Element *element)
else else
m_project = nullptr; m_project = nullptr;
//Keep up to date this widget when the linked elements of m_element change //Keep up to date this widget when the linked elements of m_element change
if (m_element) if (m_element)
disconnect(m_element.data(), &Element::linkedElementChanged, this, &MasterPropertiesWidget::updateUi); disconnect(m_element.data(), &Element::linkedElementChanged, this, &MasterPropertiesWidget::updateUi);
@@ -144,11 +144,12 @@ void MasterPropertiesWidget::setElement(Element *element)
} }
/** /**
* @brief MasterPropertiesWidget::apply @brief MasterPropertiesWidget::apply
* If link betwen edited element and other change, If link betwen 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 ???
*/ */
void MasterPropertiesWidget::apply() { void MasterPropertiesWidget::apply() {
if (QUndoCommand *undo = associatedUndo()) if (QUndoCommand *undo = associatedUndo())
@@ -156,9 +157,9 @@ void MasterPropertiesWidget::apply() {
} }
/** /**
* @brief MasterPropertiesWidget::reset @brief MasterPropertiesWidget::reset
* Reset curent widget, clear eveything and rebuild widget. Reset curent 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())
@@ -169,12 +170,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;
@@ -207,11 +208,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;
@@ -219,9 +220,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();
@@ -298,6 +299,10 @@ void MasterPropertiesWidget::updateUi()
} }
} }
/**
@brief MasterPropertiesWidget::headerCustomContextMenuRequested
@param pos
*/
void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos) void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
{ {
m_context_menu->clear(); m_context_menu->clear();
@@ -306,9 +311,9 @@ void MasterPropertiesWidget::headerCustomContextMenuRequested(const QPoint &pos)
} }
/** /**
* @brief MasterPropertiesWidget::on_link_button_clicked @brief MasterPropertiesWidget::on_link_button_clicked
* move curent item in the free_list to linked_list move curent item in the free_list to linked_list
*/ */
void MasterPropertiesWidget::on_link_button_clicked() void MasterPropertiesWidget::on_link_button_clicked()
{ {
//take the curent item from free_list and push it to linked_list //take the curent item from free_list and push it to linked_list
@@ -324,9 +329,9 @@ void MasterPropertiesWidget::on_link_button_clicked()
} }
/** /**
* @brief MasterPropertiesWidget::on_unlink_button_clicked @brief MasterPropertiesWidget::on_unlink_button_clicked
* move curent item in linked_list to free_list move curent item in linked_list to free_list
*/ */
void MasterPropertiesWidget::on_unlink_button_clicked() void MasterPropertiesWidget::on_unlink_button_clicked()
{ {
//take the curent item from linked_list and push it to free_list //take the curent item from linked_list and push it to free_list
@@ -342,11 +347,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);
@@ -365,35 +370,39 @@ 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 of edited element This slot is called when a diagram is removed from the parent project
* 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 contain slave element linked to the edited element // We use a timer because if the removed diagram
//we must to wait for this elements be unlinked, else the linked list provide deleted elements. // contain slave element linked to the edited element
// we must to wait for this elements be unlinked,
// else the linked list provide deleted elements.
QTimer::singleShot(10, this, SLOT(updateUi())); QTimer::singleShot(10, this, SLOT(updateUi()));
} }
/** /**
* @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 at the position of the mouse. // add the size of the header to display the topleft of the QMenu
//See doc about QWidget::customContextMenuRequested section related to QAbstractScrollArea // at the position of the mouse.
// See doc about QWidget::customContextMenuRequested
// section related to QAbstractScrollArea
QPoint point = pos; QPoint point = pos;
point.ry()+=ui->m_free_tree_widget->header()->height(); point.ry()+=ui->m_free_tree_widget->header()->height();

17
sources/ui/masterpropertieswidget.h
View File

@@ -35,11 +35,11 @@ namespace Ui {
} }
/** /**
* @brief The MasterPropertiesWidget class @brief The MasterPropertiesWidget class
* This class is a widget for make link between a master element with several slave element. This class is a widget for make link between a master element
* This class embenddedthe undo/redo command when apply new connection. with several slave element.
*/ This class embenddedthe undo/redo command when apply new connection.
*/
class MasterPropertiesWidget : public AbstractElementPropertiesEditorWidget class MasterPropertiesWidget : public AbstractElementPropertiesEditorWidget
{ {
Q_OBJECT Q_OBJECT
@@ -52,7 +52,12 @@ class MasterPropertiesWidget : public AbstractElementPropertiesEditorWidget
void apply() override; void apply() override;
void reset() override; void reset() override;
QUndoCommand *associatedUndo () const override; QUndoCommand *associatedUndo () const override;
QString title() const override {return tr("Référence croisée (maître)");} /**
* @brief title
* @return QString title
*/
QString title() const override {
return tr("Référence croisée (maître)");}
bool setLiveEdit(bool live_edit) override; bool setLiveEdit(bool live_edit) override;
public slots: public slots: