mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-08-03 18:44:13 +02:00
ispyisail
68c260342e
Adds a configurable wrap-at-N counter type to the autonumbering engine (NumerotationContext + NumerotationContextCommands), covering PLC/rack-style addressing conventions like "e0.0...e0.7, e1.0...e1.7" (8 channels per card) generally, rather than hardcoding octal specifically. - New "wrap" part type (WrapNum, alongside the existing UnitNum/TenNum/ HundredNum strategies) stores a modulus in addition to the existing value/increase/initialvalue fields. Its own next()/previous() only wraps its own value modulo the configured modulus -- carrying into (or borrowing from) the adjacent part requires visibility across parts, which only the composition loop has. - NumerotationContextCommands::next()/previous() gained carry()/borrow() helpers: when a wrap part's own next() would reach/exceed its modulus (or go below 0 on previous()), the nearest preceding numeric part is bumped by exactly one unit, skipping non-numeric parts (e.g. a "." string separator). Wrap parts chain correctly if adjacent (e.g. seconds wrapping into minutes wrapping into hours). - For the leading part of a wrap-and-carry pair to stay fixed except when carried into (i.e. actually produce "e0.0...e0.7, e1.0..." rather than advancing on every step under its own strategy), its own increase must be 0. The increase spinbox's minimum was 1, which made this configuration impossible through the UI -- lowered to 0 and documented with a tooltip, since this wasn't obvious from the UI alone. - NumerotationContext gained a 5th pipe-separated field (modulus) in its serialized string form, defaulting to 0 (non-wrapping) for every existing part type; toXml()/fromXml() persist it as a "modulus" XML attribute the same way "initialvalue" is already persisted for unitfolio/tenfolio/hundredfolio. - New "Cyclique (modulo)" entry in the part-type dropdown (numparteditorw), available for element, conductor, and folio autonumbering alike, since all three already go through NumerotationContextCommands. Verified in the running app via the numbering config dialog's own Suivant/Précédent buttons (which call the production NumerotationContextCommands::next()/previous() directly): a two-part context (unit, increase=0 + wrap mod 8) produced exactly e0.0→...→e0.7→e1.0→...→e1.7 on repeated "next", and the exact reverse (with correct borrowing) on repeated "previous".
213 lines
7.1 KiB
C++
213 lines
7.1 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 NUMEROTATIONCONTEXTCOMMANDS_H
|
|
#define NUMEROTATIONCONTEXTCOMMANDS_H
|
|
|
|
#include "numerotationcontext.h"
|
|
|
|
class NumStrategy;
|
|
class Diagram;
|
|
|
|
/**
|
|
@brief The NumerotationContextCommands class
|
|
this class provide methods to handle content of NumerotationContext.
|
|
*/
|
|
class NumerotationContextCommands
|
|
{
|
|
public:
|
|
NumerotationContextCommands (const NumerotationContext &, Diagram * = nullptr);
|
|
~NumerotationContextCommands ();
|
|
NumerotationContext next ();
|
|
NumerotationContext previous ();
|
|
QString toRepresentedString ();
|
|
|
|
private:
|
|
void setNumStrategy (const QString &);
|
|
static void carry(NumerotationContext &contextnum, int from_index);
|
|
static void borrow(NumerotationContext &contextnum, int from_index);
|
|
|
|
Diagram *diagram_;
|
|
NumerotationContext context_;
|
|
NumStrategy *strategy_;
|
|
};
|
|
|
|
class NumStrategy
|
|
{
|
|
public:
|
|
NumStrategy (Diagram * = nullptr);
|
|
virtual ~NumStrategy ();
|
|
virtual QString toRepresentedString (const QString) const = 0;
|
|
virtual NumerotationContext next (const NumerotationContext &, const int) const = 0;
|
|
virtual NumerotationContext previous (const NumerotationContext &, const int) const = 0;
|
|
|
|
protected:
|
|
NumerotationContext nextString (const NumerotationContext &, const int) const;
|
|
NumerotationContext nextNumber (const NumerotationContext &, const int) const;
|
|
NumerotationContext previousNumber (const NumerotationContext &, const int) const;
|
|
|
|
Diagram *diagram_;
|
|
};
|
|
|
|
class UnitNum: public NumStrategy
|
|
{
|
|
public:
|
|
UnitNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class UnitFNum: public NumStrategy
|
|
{
|
|
public:
|
|
UnitFNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class TenNum: public NumStrategy
|
|
{
|
|
public:
|
|
TenNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class TenFNum: public NumStrategy
|
|
{
|
|
public:
|
|
TenFNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class HundredNum: public NumStrategy
|
|
{
|
|
public:
|
|
HundredNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class HundredFNum: public NumStrategy
|
|
{
|
|
public:
|
|
HundredFNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
/**
|
|
@brief The WrapNum class
|
|
A counter that wraps back to 0 (borrowing from initialvalue on the
|
|
way down) every `modulus` values, instead of counting up forever like
|
|
UnitNum/TenNum/HundredNum. Its own next()/previous() only computes its
|
|
own wrapped value; carrying into (or borrowing from) the preceding
|
|
numeric part is handled by NumerotationContextCommands::next()/
|
|
previous(), since only the composition loop can see adjacent parts.
|
|
*/
|
|
class WrapNum: public NumStrategy
|
|
{
|
|
public:
|
|
WrapNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class StringNum: public NumStrategy
|
|
{
|
|
public:
|
|
StringNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class IdFolioNum: public NumStrategy
|
|
{
|
|
public:
|
|
IdFolioNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class FolioNum: public NumStrategy
|
|
{
|
|
public:
|
|
FolioNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class PlantNum: public NumStrategy
|
|
{
|
|
public:
|
|
PlantNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class LocmachNum: public NumStrategy
|
|
{
|
|
public:
|
|
LocmachNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
|
|
class ElementLineNum: public NumStrategy
|
|
{
|
|
public:
|
|
ElementLineNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class ElementColumnNum: public NumStrategy
|
|
{
|
|
public:
|
|
ElementColumnNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
class ElementPrefixNum: public NumStrategy
|
|
{
|
|
public:
|
|
ElementPrefixNum (Diagram *);
|
|
QString toRepresentedString(const QString) const override;
|
|
NumerotationContext next (const NumerotationContext &, const int) const override;
|
|
NumerotationContext previous (const NumerotationContext &, const int) const override;
|
|
};
|
|
|
|
|
|
#endif // NUMEROTATIONCONTEXTCOMMANDS_H
|