KiCad PCB EDA Suite
Loading...
Searching...
No Matches
sch_textbox.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <https://www.gnu.org/licenses/>.
18 */
19
20#ifndef SCH_TEXTBOX_H
21#define SCH_TEXTBOX_H
22
23
24#include <eda_text.h>
25#include <sch_shape.h>
26#include <schematic.h>
27
28
30
31class SCH_TEXTBOX : public SCH_SHAPE, public EDA_TEXT
32{
33public:
34 SCH_TEXTBOX( SCH_LAYER_ID aLayer = LAYER_NOTES, int aLineWidth = 0,
35 FILL_T aFillType = FILL_T::NO_FILL, const wxString& aText = wxEmptyString,
36 KICAD_T aType = SCH_TEXTBOX_T );
37
38 SCH_TEXTBOX( const SCH_TEXTBOX& aText );
39
41
42 void Serialize( google::protobuf::Any& aContainer ) const override;
43 bool Deserialize( const google::protobuf::Any& aContainer ) override;
44
45 static bool ClassOf( const EDA_ITEM* aItem )
46 {
47 return aItem && SCH_TEXTBOX_T == aItem->Type();
48 }
49
50 wxString GetClass() const override
51 {
52 return wxT( "SCH_TEXTBOX" );
53 }
54
55 int GetLegacyTextMargin() const;
56
62 VECTOR2I GetMinSize() const;
63
64 void SetMarginLeft( int aLeft ) { m_marginLeft = aLeft; }
65 void SetMarginTop( int aTop ) { m_marginTop = aTop; }
66 void SetMarginRight( int aRight ) { m_marginRight = aRight; }
67 void SetMarginBottom( int aBottom ) { m_marginBottom = aBottom; }
68
69 int GetMarginLeft() const { return m_marginLeft; }
70 int GetMarginTop() const { return m_marginTop; }
71 int GetMarginRight() const { return m_marginRight; }
72 int GetMarginBottom() const { return m_marginBottom; }
73
74 int GetSchTextSize() const { return GetTextWidth(); }
75 void SetSchTextSize( int aSize ) { SetTextSize( VECTOR2I( aSize, aSize ) ); }
76
77 VECTOR2I GetDrawPos() const override;
78
79 KIFONT::FONT* GetDrawFont( const RENDER_SETTINGS* aSettings ) const override;
80
81 virtual wxString GetShownText( const RENDER_SETTINGS* aSettings, const SCH_SHEET_PATH* aPath,
82 bool aAllowExtraText, int aDepth = 0 ) const;
83
84 wxString GetShownText( bool aAllowExtraText, int aDepth = 0 ) const override
85 {
86 SCH_SHEET_PATH* sheetPath = nullptr;
87
88 if( SCHEMATIC* schematic = Schematic() )
89 sheetPath = &schematic->CurrentSheet();
90
91 return GetShownText( nullptr, sheetPath, aAllowExtraText, aDepth );
92 }
93
94 bool HasHypertext() const override;
95 bool HasHoveredHypertext() const override;
96 void DoHypertextAction( EDA_DRAW_FRAME* aFrame, const VECTOR2I& aMousePos ) const override;
97
98 void SetExcludedFromSim( bool aExclude, const SCH_SHEET_PATH* aInstance = nullptr,
99 const wxString& aVariantName = wxEmptyString ) override
100 {
101 m_excludedFromSim = aExclude;
102 }
103
104 bool GetExcludedFromSim( const SCH_SHEET_PATH* aInstance = nullptr,
105 const wxString& aVariantName = wxEmptyString ) const override
106 {
107 return m_excludedFromSim;
108 }
109
110 bool operator<( const SCH_ITEM& aItem ) const override;
111
112 void Move( const VECTOR2I& aMoveVector ) override
113 {
114 EDA_SHAPE::move( aMoveVector );
115 EDA_TEXT::Offset( aMoveVector );
116 }
117
118 void MirrorHorizontally( int aCenter ) override;
119 void MirrorVertically( int aCenter ) override;
120 void Rotate( const VECTOR2I& aCenter, bool aRotateCCW ) override;
121
122 virtual void Rotate90( bool aClockwise );
123
124 bool HitTest( const VECTOR2I& aPosition, int aAccuracy = 0 ) const override;
125
126 bool HitTest( const BOX2I& aRect, bool aContained, int aAccuracy = 0 ) const override;
127 bool HitTest( const SHAPE_LINE_CHAIN& aPoly, bool aContained ) const override;
128
129 bool Matches( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) const override
130 {
131 return SCH_ITEM::Matches( GetText(), aSearchData );
132 }
133
134 bool Replace( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) override
135 {
136 return EDA_TEXT::Replace( aSearchData );
137 }
138
139 virtual bool IsReplaceable() const override { return true; }
140
141 wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, bool aFull ) const override;
142
143 BITMAPS GetMenuImage() const override;
144
145 void Plot( PLOTTER* aPlotter, bool aBackground, const SCH_PLOT_OPTS& aPlotOpts,
146 int aUnit, int aBodyStyle, const VECTOR2I& aOffset, bool aDimmed ) override;
147
148 EDA_ITEM* Clone() const override
149 {
150 return new SCH_TEXTBOX( *this );
151 }
152
153 void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
154
155 double Similarity( const SCH_ITEM& aOther ) const override;
156
157 bool operator==( const SCH_ITEM& aOther ) const override;
158
159protected:
160 void swapData( SCH_ITEM* aItem ) override;
161
162 const KIFONT::METRICS& getFontMetrics() const override { return GetFontMetrics(); }
163
164 int compare( const SCH_ITEM& aOther, int aCompareFlags = 0 ) const override;
165
166protected:
172};
173
174
175#endif /* SCH_TEXTBOX_H */
BITMAPS
A list of all bitmap identifiers.
BOX2< VECTOR2I > BOX2I
Definition box2.h:918
The base class for create windows for drawing purpose.
KICAD_T Type() const
Returns the type of object.
Definition eda_item.h:108
virtual bool Matches(const EDA_SEARCH_DATA &aSearchData, void *aAuxData) const
Compare the item against the search criteria in aSearchData.
Definition eda_item.h:416
EDA_ITEM(EDA_ITEM *parent, KICAD_T idType, bool isSCH_ITEM=false, bool isBOARD_ITEM=false)
Definition eda_item.cpp:37
void move(const VECTOR2I &aMoveVector)
virtual void SetTextSize(VECTOR2I aNewSize, bool aEnforceMinTextSize=true)
Definition eda_text.cpp:532
virtual const wxString & GetText() const
Return the string associated with the text object.
Definition eda_text.h:110
virtual void Offset(const VECTOR2I &aOffset)
Definition eda_text.cpp:595
virtual int GetTextWidth() const
Definition eda_text.h:285
bool Replace(const EDA_SEARCH_DATA &aSearchData)
Helper function used in search and replace dialog.
Definition eda_text.cpp:482
EDA_TEXT(const EDA_IU_SCALE &aIuScale, const wxString &aText=wxEmptyString)
Definition eda_text.cpp:98
FONT is an abstract base class for both outline and stroke fonts.
Definition font.h:94
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
Base plotter engine class.
Definition plotter.h:133
Holds all the data relating to one schematic.
Definition schematic.h:90
Base class for any item which can be embedded within the SCHEMATIC container class,...
Definition sch_item.h:162
SCHEMATIC * Schematic() const
Search the item hierarchy to find a SCHEMATIC.
Definition sch_item.cpp:268
const KIFONT::METRICS & GetFontMetrics() const
Definition sch_item.cpp:781
SCH_SHAPE(SHAPE_T aShape=SHAPE_T::UNDEFINED, SCH_LAYER_ID aLayer=LAYER_NOTES, int aLineWidth=0, FILL_T aFillType=FILL_T::NO_FILL, KICAD_T aType=SCH_SHAPE_T)
Definition sch_shape.cpp:40
Handle access to a stack of flattened SCH_SHEET objects by way of a path for creating a flattened sch...
void SetMarginBottom(int aBottom)
Definition sch_textbox.h:67
bool Matches(const EDA_SEARCH_DATA &aSearchData, void *aAuxData) const override
Compare the item against the search criteria in aSearchData.
int GetMarginBottom() const
Definition sch_textbox.h:72
void MirrorHorizontally(int aCenter) override
Mirror item horizontally about aCenter.
bool m_excludedFromSim
virtual wxString GetShownText(const RENDER_SETTINGS *aSettings, const SCH_SHEET_PATH *aPath, bool aAllowExtraText, int aDepth=0) const
bool operator==(const SCH_ITEM &aOther) const override
wxString GetItemDescription(UNITS_PROVIDER *aUnitsProvider, bool aFull) const override
Return a user-visible description string of this item.
bool HitTest(const VECTOR2I &aPosition, int aAccuracy=0) const override
Test if aPosition is inside or on the boundary of this item.
int GetLegacyTextMargin() const
int GetMarginLeft() const
Definition sch_textbox.h:69
int GetSchTextSize() const
Definition sch_textbox.h:74
wxString GetShownText(bool aAllowExtraText, int aDepth=0) const override
Return the string actually shown after processing of the base text.
Definition sch_textbox.h:84
virtual bool IsReplaceable() const override
Override this method in any derived object that supports test find and replace.
bool GetExcludedFromSim(const SCH_SHEET_PATH *aInstance=nullptr, const wxString &aVariantName=wxEmptyString) const override
int compare(const SCH_ITEM &aOther, int aCompareFlags=0) const override
Provide the draw object specific comparison called by the == and < operators.
BITMAPS GetMenuImage() const override
Return a pointer to an image to be used in menus.
bool operator<(const SCH_ITEM &aItem) const override
bool Deserialize(const google::protobuf::Any &aContainer) override
Deserializes the given protobuf message into this object.
wxString GetClass() const override
Return the class name.
Definition sch_textbox.h:50
bool HasHypertext() const override
Indicates that the item has at least one hypertext action.
const KIFONT::METRICS & getFontMetrics() const override
VECTOR2I GetDrawPos() const override
int GetMarginRight() const
Definition sch_textbox.h:71
void Rotate(const VECTOR2I &aCenter, bool aRotateCCW) override
Rotate the item around aCenter 90 degrees in the clockwise direction.
VECTOR2I GetMinSize() const
Return the minimum height needed to contain the textbox's wrapped text content plus margins.
void Plot(PLOTTER *aPlotter, bool aBackground, const SCH_PLOT_OPTS &aPlotOpts, int aUnit, int aBodyStyle, const VECTOR2I &aOffset, bool aDimmed) override
Plot the item to aPlotter.
bool Replace(const EDA_SEARCH_DATA &aSearchData, void *aAuxData) override
Perform a text replace using the find and replace criteria in aSearchData on items that support text ...
bool HasHoveredHypertext() const override
Indicates that a hypertext link is currently active.
EDA_ITEM * Clone() const override
Create a duplicate of this item with linked list members set to NULL.
static bool ClassOf(const EDA_ITEM *aItem)
Definition sch_textbox.h:45
int GetMarginTop() const
Definition sch_textbox.h:70
void Move(const VECTOR2I &aMoveVector) override
Move the item by aMoveVector to a new position.
void Serialize(google::protobuf::Any &aContainer) const override
Serializes this object to the given Any message.
void GetMsgPanelInfo(EDA_DRAW_FRAME *aFrame, std::vector< MSG_PANEL_ITEM > &aList) override
Populate aList of MSG_PANEL_ITEM objects with it's internal state for display purposes.
void SetMarginLeft(int aLeft)
Definition sch_textbox.h:64
void swapData(SCH_ITEM *aItem) override
Swap the internal data structures aItem with the schematic item.
void DoHypertextAction(EDA_DRAW_FRAME *aFrame, const VECTOR2I &aMousePos) const override
virtual void Rotate90(bool aClockwise)
void SetMarginRight(int aRight)
Definition sch_textbox.h:66
void SetSchTextSize(int aSize)
Definition sch_textbox.h:75
KIFONT::FONT * GetDrawFont(const RENDER_SETTINGS *aSettings) const override
SCH_TEXTBOX(SCH_LAYER_ID aLayer=LAYER_NOTES, int aLineWidth=0, FILL_T aFillType=FILL_T::NO_FILL, const wxString &aText=wxEmptyString, KICAD_T aType=SCH_TEXTBOX_T)
double Similarity(const SCH_ITEM &aOther) const override
Return a measure of how likely the other object is to represent the same object.
void MirrorVertically(int aCenter) override
Mirror item vertically about aCenter.
void SetExcludedFromSim(bool aExclude, const SCH_SHEET_PATH *aInstance=nullptr, const wxString &aVariantName=wxEmptyString) override
Definition sch_textbox.h:98
void SetMarginTop(int aTop)
Definition sch_textbox.h:65
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
FILL_T
Definition eda_shape.h:59
@ NO_FILL
Definition eda_shape.h:60
SCH_LAYER_ID
Eeschema drawing layers.
Definition layer_ids.h:447
@ LAYER_NOTES
Definition layer_ids.h:465
KICAD_T
The set of class identification values stored in EDA_ITEM::m_structType.
Definition typeinfo.h:71
@ SCH_TEXTBOX_T
Definition typeinfo.h:149
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:683