Files
ispyisail f7591e0c9d Add grouping of folio items: Group and Ungroup (#1070)
Symbols, free texts, shapes and pictures can be grouped from the Edit
menu, the selection's context menu or the command search. Clicking one
member selects the group, so moving, copying and deleting act on all of
it; Ctrl+click on a member deselects the group; a rubber band touching
part of a group selects all of it when released. No default shortcut:
Ctrl+G is "jump to element".

A group is not an object in the scene. Each member keeps its place and
carries the group's uuid (QGraphicsItem::data()), saved as a "group"
attribute written only when set: a project without groups saves exactly
as before, and older versions open a grouped one and ignore the groups.
Re-parenting under a QGraphicsItemGroup would have made every member's
position group-relative; ElementTextItemGroup already needs nine special
cases for that.

- Selection is completed on clicks and at the end of a rubber band, not
  on every selectionChanged(): export, search and Tab select items
  themselves and must not have groups pulled back in.
- Project database: group_uuid on element, shape, independent_text and
  image, kept in step by projectDataBase::itemGroupChanged().
- Paste and folio duplication give each source group one new uuid.
- Undo of Ungroup restores each item's exact group.

Builds on #1065 (uuids and database rows for texts, shapes and images).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G2d2Zi8BfrYRPX88zhaoFG
2026-09-27 21:14:47 +13:00

63 lines
1.8 KiB
C++

/*
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/>.
*/
#ifndef GROUPITEMSCOMMAND_H
#define GROUPITEMSCOMMAND_H
#include <QList>
#include <QPointer>
#include <QUndoCommand>
#include <QUuid>
class Diagram;
class QGraphicsItem;
class QGraphicsObject;
/**
@brief The GroupItemsCommand class
Groups or ungroups the selected items of a diagram (discussion #1070).
Undo gives every item back the exact group it had, so a redo after it
still refers to the same groups.
*/
class GroupItemsCommand : public QUndoCommand
{
public:
static GroupItemsCommand *group(Diagram *diagram);
static GroupItemsCommand *ungroup(Diagram *diagram);
static bool isGroupable(const QGraphicsItem *item);
static bool canGroup(Diagram *diagram);
static bool canUngroup(Diagram *diagram);
void undo() override;
void redo() override;
private:
GroupItemsCommand(Diagram *diagram, const QList<QGraphicsObject *> &items, const QUuid &group);
void apply(bool redo);
struct Change {
QPointer<QGraphicsObject> item;
QUuid before;
};
QPointer<Diagram> m_diagram;
QList<Change> m_changes;
QUuid m_group;
};
#endif // GROUPITEMSCOMMAND_H