1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
// SPDX-FileCopyrightText: 2002 Dominique Devriese <devriese@kde.org>
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#include "../misc/argsparser.h"
#include "common.h"
class ObjectTypeCalcer;
/**
* The ObjectType class is a thing that represents the "behaviour" for
* a certain type. This basically means that it decides what
* \ref ObjectImp the object gets in the calc() function, how the
* object move()'s etc.
*/
class ObjectType
{
const char *mfulltypename;
protected:
ObjectType(const char fulltypename[]);
public:
virtual ~ObjectType();
enum { ID_ConstrainedPointType, ID_LocusType, ID_FixedPointType };
virtual bool inherits(int type) const;
virtual ObjectImp *calc(const Args &parents, const KigDocument &d) const = 0;
virtual bool canMove(const ObjectTypeCalcer &ourobj) const;
virtual bool isFreelyTranslatable(const ObjectTypeCalcer &ourobj) const;
virtual std::vector<ObjectCalcer *> movableParents(const ObjectTypeCalcer &ourobj) const;
virtual const Coordinate moveReferencePoint(const ObjectTypeCalcer &ourobj) const;
virtual void move(ObjectTypeCalcer &ourobj, const Coordinate &to, const KigDocument &d) const;
const char *fullName() const;
/**
* Supposing that \p parents would be given as parents to
* this type's calc function, this function returns the ObjectImp id
* that \p o should at least have. ( \p o should be part of \p parents )
*/
virtual const ObjectImpType *impRequirement(const ObjectImp *o, const Args &parents) const = 0;
/**
* Supposing that \p parents would be given as parents to this type's
* calc function, this function returns whether the returned
* ObjectImp will be, by construction, on \p o ( if \p o is a curve ), or
* through \p o ( if \p o is a point ).
*/
virtual bool isDefinedOnOrThrough(const ObjectImp *o, const Args &parents) const = 0;
/**
* returns the ObjectImp id of the ObjectImp's produced by this
* ObjectType. if the ObjectType can return different sorts of
* ObjectImp's, it should return the biggest common id, or
* ID_AnyImp.
*/
virtual const ObjectImpType *resultId() const = 0;
virtual std::vector<ObjectCalcer *> sortArgs(const std::vector<ObjectCalcer *> &args) const = 0;
virtual Args sortArgs(const Args &args) const = 0;
/**
* is this object type a transformation type. We want to know this
* cause transform types are shown separately in an object's RMB
* menu.
*/
virtual bool isTransform() const;
// ObjectType's can define some special actions, that are strictly
// specific to the type at hand. E.g. a text label allows to toggle
// the display of a frame around the text. Constrained and fixed
// points can be redefined etc.
/**
* return i18n'd names for the special actions.
*/
virtual QStringList specialActions() const;
/**
* execute the \p i 'th action from the specialActions above.
*/
virtual void executeAction(int i, ObjectHolder &o, ObjectTypeCalcer &t, KigPart &d, KigWidget &w, NormalMode &m) const;
};
/**
* This is a convenience subclass of ObjectType that a type should
* inherit from if its parents can be specified in an ArgsParser.
*/
class ArgsParserObjectType : public ObjectType
{
protected:
const ArgsParser margsparser;
ArgsParserObjectType(const char fulltypename[], const struct ArgsParser::spec argsspec[], int n);
public:
const ObjectImpType *impRequirement(const ObjectImp *o, const Args &parents) const override;
bool isDefinedOnOrThrough(const ObjectImp *o, const Args &parents) const override;
const ArgsParser &argsParser() const;
std::vector<ObjectCalcer *> sortArgs(const std::vector<ObjectCalcer *> &args) const override;
Args sortArgs(const Args &args) const override;
};
|
