qelectrotech-source-mirror/sources/titleblock/qettemplateeditor.h

/*
	Copyright 2006-2025 The QElectroTech Team
	This file is part of QElectroTech.

	QElectroTech is free software: you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation, either version 2 of the License, or
	(at your option) any later version.

	QElectroTech is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with QElectroTech.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef TITLEBLOCK_SLASH_QET_TEMPLATE_EDITOR_H
#define TITLEBLOCK_SLASH_QET_TEMPLATE_EDITOR_H
#include "../qet.h"
#include "../qetmainwindow.h"
#include "templatelocation.h"
#include "templateview.h"

#include <QCloseEvent>
#include <QtWidgets>
class ModifyTitleBlockCellCommand;
class TitleBlockTemplateCommand;
class TitleBlockTemplateCellWidget;
class TitleBlockTemplateLogoManager;
class QETProject;

/**
	This class implements the main window of QElectroTech's titleblock template
	editor. This editor aims at allowing users to easily create their own title
	block templates.
*/
class QETTitleBlockTemplateEditor : public QETMainWindow {
	Q_OBJECT

	// constructor, destructor
	public:
	QETTitleBlockTemplateEditor(QWidget * = nullptr);
	~QETTitleBlockTemplateEditor() override;
	private:
	QETTitleBlockTemplateEditor(const QETTitleBlockTemplateEditor &);

	// attributes
	private:
	/// menus TODO
#if TODO_LIST
#pragma message("@TODO menus")
#endif
	QMenu *file_menu_, *edit_menu_, *display_menu_;
	/// actions
	QAction *new_, *open_, *open_from_file_, *save_, *save_as_, *save_as_file_, *quit_;
	QAction *undo_, *redo_, *cut_, *copy_, *paste_, *edit_logos_, *edit_info_, *add_row_, *add_col_, *merge_cells_, *split_cell_;
	QAction *zoom_in_, *zoom_out_, *zoom_fit_, *zoom_reset_;
	/// Location of the currently edited template
	TitleBlockTemplateLocation location_;
	/// Filepath of the currently edited template, if opened from a file
	QString filepath_;
	/// Whether to consider the location or the filepath
	bool opened_from_file_;
	/// whether the currently edited template is considered read only
	bool read_only_;
	/**
		Whether to ask the user a new template name when the window appears in order
		to rename the edited template.
	*/
	bool duplicate_;
	/// Used to track the first activation of the editor main window.
	bool first_activation_;
	/// Template Object edited
	TitleBlockTemplate *tb_template_;
	/// Template preview
	QGraphicsScene *template_edition_area_scene_;
	TitleBlockTemplateView *template_edition_area_view_;
	/// Individual cell widget edition
	QDockWidget *template_cell_editor_dock_widget_;
	TitleBlockTemplateCellWidget *template_cell_editor_widget_;
	/// Logo manager widget
	TitleBlockTemplateLogoManager *logo_manager_;
	/// Undo interface
	QUndoStack *undo_stack_;
	QUndoView *undo_view_;
	QDockWidget *undo_dock_widget_;

	// methods
	public:
	TitleBlockTemplateLocation location() const;
	bool isEditing(const QString &ilepath);
	void setOpenForDuplication(bool);
	bool openForDuplication() const;

	protected:
	bool canClose();
	void firstActivation(QEvent *) override;
	void closeEvent(QCloseEvent *) override;

	private:
	void initActions();
	void initMenus();
	void initToolbars();
	void initWidgets();
	void initLogoManager();
	QString currentlyEditedTitle() const;

	public slots:
	void readSettings();
	void writeSettings();
	void selectedCellsChanged(const QList<TitleBlockCell *>&);
	void duplicateCurrentLocation();
	bool edit(const TitleBlockTemplateLocation &);
	bool edit(QETProject *, const QString &);
	bool edit(const QString &);
	bool editCopyOf(const TitleBlockTemplate *);
	bool edit(TitleBlockTemplate *);
	void editLogos();
	void newTemplate();
	void open();
	void openFromFile();
	bool save();
	bool saveAs();
	bool saveAsFile();
	void setReadOnly(bool);
	void quit();
	void savePreviewWidthToApplicationSettings(int, int);
	void editTemplateInformation();

	private slots:
	TitleBlockTemplateLocation getTitleBlockTemplateLocationFromUser(const QString & = QString(), bool existing_only = true);
	void pushCellUndoCommand(ModifyTitleBlockCellCommand *);
	void pushGridUndoCommand(TitleBlockTemplateCommand *);
	void pushUndoCommand(QUndoCommand *);
	void updateEditorTitle();
	void updateActions();
	bool saveAs(const TitleBlockTemplateLocation &);
	bool saveAs(const QString &);
};

#endif