Place symbol texts: label and notes as one block, at one of nine points

A new command, "Place symbol texts", for the selected symbols: their
label and the notes beside it go as one block next to the drawing of
the symbol, 3 px away, at one of the nine points of the text alignment
dialog, chosen in a 3 x 3 grid that opens from the toolbar button and
from the Edit menu. A click on the button places them at the point
chosen last (left of the symbol at first).

Left of the symbol the lines are aligned right, so that they hang on it
and a longer text grows away from it (their alignment is set too);
right of it aligned left; above, below and on it centred. The lines
keep their order and their spacing, a group of texts is placed as one
line with the same alignment, a turned symbol is placed in the folio's
directions, and everything is one undo step.

Element::drawingRect() gives the area the drawing covers, tighter than
the bounding rect, which is rounded up to the grid. A toolbar command
with a menu now shows as a button with an arrow beside it.
Translations for all languages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

sources/symboltextplacement.cpp

@@ -0,0 +1,129 @@
+/*
+	Copyright 2006-2026 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/>.
+*/
+#include "symboltextplacement.h"
+
+#include "QPropertyUndoCommand/qpropertyundocommand.h"
+#include "qetgraphicsitem/dynamicelementtextitem.h"
+#include "qetgraphicsitem/element.h"
+#include "qetgraphicsitem/elementtextitemgroup.h"
+
+#include <QCoreApplication>
+#include <QUndoCommand>
+
+namespace {
+
+	/// How the lines of the block line up, for a block placed at @a where
+Qt::Alignment linesFor(Qt::Alignment where)
+{
+	if (where & Qt::AlignLeft)  return Qt::AlignRight;
+	if (where & Qt::AlignRight) return Qt::AlignLeft;
+	return Qt::AlignHCenter;
+}
+
+	/// One line of the block: a text, or a group of texts
+struct Line
+{
+	QObject *object;		///< for its properties
+	QGraphicsItem *item;	///< for where it stands
+	QPointF old_pos;
+	QVariant old_alignment;
+};
+
+	/// Move @a item so that the top left of its box in the folio is at @a to
+void moveTo(QGraphicsItem *item, const QPointF &to)
+{
+	const QPointF by = to - item->sceneBoundingRect().topLeft();
+	QGraphicsItem *parent = item->parentItem();
+	const QPointF step = parent ? parent->mapFromScene(by) - parent->mapFromScene(QPointF(0, 0))
+								: by;
+	item->setPos(item->pos() + step);
+}
+
+bool placeOne(Element *element, Qt::Alignment where, QUndoCommand *parent)
+{
+	const Qt::Alignment lines_alignment = linesFor(where);
+
+	QList<Line> lines;
+	for (DynamicElementTextItem *text : element->dynamicTextItems())
+		if (!text->parentGroup() && text->isVisible())
+			lines.append({text, text, text->pos(), text->property("alignment")});
+	for (ElementTextItemGroup *group : element->textGroups())
+		if (group->isVisible())
+			lines.append({group, group, group->pos(), group->property("alignment")});
+	if (lines.isEmpty())
+		return false;
+
+		//The lines first take the alignment of the block: a group lays its
+		//texts out anew, and later changes of a text keep that side.
+	for (const Line &line : lines)
+	{
+		Qt::Alignment a = line.old_alignment.value<Qt::Alignment>();
+		if (qobject_cast<ElementTextItemGroup *>(line.object))
+			a = lines_alignment == Qt::AlignHCenter ? Qt::AlignVCenter : lines_alignment;
+		else
+			a = (a & Qt::AlignVertical_Mask) | lines_alignment;
+		line.object->setProperty("alignment", QVariant::fromValue(a));
+	}
+
+	QRectF block;
+	for (const Line &line : lines)
+		block |= line.item->sceneBoundingRect();
+
+	const QRectF body = element->mapRectToScene(element->drawingRect());
+	const qreal gap = SymbolTextPlacement::gap;
+	QRectF to = block;
+	if (where & Qt::AlignLeft)        to.moveRight(body.left() - gap);
+	else if (where & Qt::AlignRight)  to.moveLeft(body.right() + gap);
+	else                              to.moveLeft(body.center().x() - block.width() / 2);
+	if (where & Qt::AlignTop)         to.moveBottom(body.top() - gap);
+	else if (where & Qt::AlignBottom) to.moveTop(body.bottom() + gap);
+	else                              to.moveTop(body.center().y() - block.height() / 2);
+
+	for (const Line &line : lines)
+	{
+		const QRectF box = line.item->sceneBoundingRect();
+		const qreal y = to.top() + box.top() - block.top();
+		const qreal x = lines_alignment == Qt::AlignRight ? to.right() - box.width()
+					  : lines_alignment == Qt::AlignLeft  ? to.left()
+					  : to.center().x() - box.width() / 2;
+		moveTo(line.item, QPointF(x, y));
+
+		const QVariant alignment = line.object->property("alignment");
+		if (alignment != line.old_alignment)
+			new QPropertyUndoCommand(line.object, "alignment", line.old_alignment, alignment, parent);
+		if (line.item->pos() != line.old_pos)
+			new QPropertyUndoCommand(line.object, "pos", line.old_pos, line.item->pos(), parent);
+	}
+	return true;
+}
+
+} // namespace
+
+QUndoCommand *SymbolTextPlacement::place(const QList<Element *> &elements, Qt::Alignment where)
+{
+	auto *undo = new QUndoCommand(
+				QCoreApplication::translate("SymbolTextPlacement", "Place symbol texts"));
+	bool any = false;
+	for (Element *element : elements)
+		any |= placeOne(element, where, undo);
+	if (!any || !undo->childCount()) {
+		delete undo;
+		return nullptr;
+	}
+	return undo;
+}