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, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24#ifndef SCH_TEXTBOX_H
25#define SCH_TEXTBOX_H
26
27
28#include <eda_text.h>
29#include <sch_shape.h>
30#include <schematic.h>
31
32
34
35class SCH_TEXTBOX : public SCH_SHAPE, public EDA_TEXT
36{
37public:
38 SCH_TEXTBOX( SCH_LAYER_ID aLayer = LAYER_NOTES, int aLineWidth = 0,
39 FILL_T aFillType = FILL_T::NO_FILL, const wxString& aText = wxEmptyString,
40 KICAD_T aType = SCH_TEXTBOX_T );
41
42 SCH_TEXTBOX( const SCH_TEXTBOX& aText );
43
45
46 void Serialize( google::protobuf::Any& aContainer ) const override;
47 bool Deserialize( const google::protobuf::Any& aContainer ) override;
48
49 static bool ClassOf( const EDA_ITEM* aItem )
50 {
51 return aItem && SCH_TEXTBOX_T == aItem->Type();
52 }
53
54 wxString GetClass() const override
55 {
56 return wxT( "SCH_TEXTBOX" );
57 }
58
59 int GetLegacyTextMargin() const;
60
66 VECTOR2I GetMinSize() const;
67
68 void SetMarginLeft( int aLeft ) { m_marginLeft = aLeft; }
69 void SetMarginTop( int aTop ) { m_marginTop = aTop; }
70 void SetMarginRight( int aRight ) { m_marginRight = aRight; }
71 void SetMarginBottom( int aBottom ) { m_marginBottom = aBottom; }
72
73 int GetMarginLeft() const { return m_marginLeft; }
74 int GetMarginTop() const { return m_marginTop; }
75 int GetMarginRight() const { return m_marginRight; }
76 int GetMarginBottom() const { return m_marginBottom; }
77
78 int GetSchTextSize() const { return GetTextWidth(); }
79 void SetSchTextSize( int aSize ) { SetTextSize( VECTOR2I( aSize, aSize ) ); }
80
81 VECTOR2I GetDrawPos() const override;
82
83 KIFONT::FONT* GetDrawFont( const RENDER_SETTINGS* aSettings ) const override;
84
85 virtual wxString GetShownText( const RENDER_SETTINGS* aSettings, const SCH_SHEET_PATH* aPath,
86 bool aAllowExtraText, int aDepth = 0 ) const;
87
88 wxString GetShownText( bool aAllowExtraText, int aDepth = 0 ) const override
89 {
90 SCH_SHEET_PATH* sheetPath = nullptr;
91
92 if( SCHEMATIC* schematic = Schematic() )
93 sheetPath = &schematic->CurrentSheet();
94
95 return GetShownText( nullptr, sheetPath, aAllowExtraText, aDepth );
96 }
97
98 bool HasHypertext() const override;
99 bool HasHoveredHypertext() const override;
100 void DoHypertextAction( EDA_DRAW_FRAME* aFrame, const VECTOR2I& aMousePos ) const override;
101
102 void SetExcludedFromSim( bool aExclude, const SCH_SHEET_PATH* aInstance = nullptr,
103 const wxString& aVariantName = wxEmptyString ) override
104 {
105 m_excludedFromSim = aExclude;
106 }
107
108 bool GetExcludedFromSim( const SCH_SHEET_PATH* aInstance = nullptr,
109 const wxString& aVariantName = wxEmptyString ) const override
110 {
111 return m_excludedFromSim;
112 }
113
114 bool operator<( const SCH_ITEM& aItem ) const override;
115
116 void Move( const VECTOR2I& aMoveVector ) override
117 {
118 EDA_SHAPE::move( aMoveVector );
119 EDA_TEXT::Offset( aMoveVector );
120 }
121
122 void MirrorHorizontally( int aCenter ) override;
123 void MirrorVertically( int aCenter ) override;
124 void Rotate( const VECTOR2I& aCenter, bool aRotateCCW ) override;
125
126 virtual void Rotate90( bool aClockwise );
127
128 bool HitTest( const VECTOR2I& aPosition, int aAccuracy = 0 ) const override;
129
130 bool HitTest( const BOX2I& aRect, bool aContained, int aAccuracy = 0 ) const override;
131 bool HitTest( const SHAPE_LINE_CHAIN& aPoly, bool aContained ) const override;
132
133 bool Matches( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) const override
134 {
135 return SCH_ITEM::Matches( GetText(), aSearchData );
136 }
137
138 bool Replace( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) override
139 {
140 return EDA_TEXT::Replace( aSearchData );
141 }
142
143 virtual bool IsReplaceable() const override { return true; }
144
145 wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, bool aFull ) const override;
146
147 BITMAPS GetMenuImage() const override;
148
149 void Plot( PLOTTER* aPlotter, bool aBackground, const SCH_PLOT_OPTS& aPlotOpts,
150 int aUnit, int aBodyStyle, const VECTOR2I& aOffset, bool aDimmed ) override;
151
152 EDA_ITEM* Clone() const override
153 {
154 return new SCH_TEXTBOX( *this );
155 }
156
157 void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
158
159 double Similarity( const SCH_ITEM& aOther ) const override;
160
161 bool operator==( const SCH_ITEM& aOther ) const override;
162
163protected:
164 void swapData( SCH_ITEM* aItem ) override;
165
166 const KIFONT::METRICS& getFontMetrics() const override { return GetFontMetrics(); }
167
168 int compare( const SCH_ITEM& aOther, int aCompareFlags = 0 ) const override;
169
170protected:
176};
177
178
179#endif /* SCH_TEXTBOX_H */
BITMAPS
A list of all bitmap identifiers.
BOX2< VECTOR2I > BOX2I
Definition box2.h:922
The base class for create windows for drawing purpose.
KICAD_T Type() const
Returns the type of object.
Definition eda_item.h:112
virtual bool Matches(const EDA_SEARCH_DATA &aSearchData, void *aAuxData) const
Compare the item against the search criteria in aSearchData.
Definition eda_item.h:413
EDA_ITEM(EDA_ITEM *parent, KICAD_T idType, bool isSCH_ITEM=false, bool isBOARD_ITEM=false)
Definition eda_item.cpp:41
void move(const VECTOR2I &aMoveVector)
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:114
int GetTextWidth() const
Definition eda_text.h:289
void Offset(const VECTOR2I &aOffset)
Definition eda_text.cpp:594
bool Replace(const EDA_SEARCH_DATA &aSearchData)
Helper function used in search and replace dialog.
Definition eda_text.cpp:486
EDA_TEXT(const EDA_IU_SCALE &aIuScale, const wxString &aText=wxEmptyString)
Definition eda_text.cpp:102
FONT is an abstract base class for both outline and stroke fonts.
Definition font.h:98
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
Base plotter engine class.
Definition plotter.h:136
Holds all the data relating to one schematic.
Definition schematic.h:89
Base class for any item which can be embedded within the SCHEMATIC container class,...
Definition sch_item.h:168
SCHEMATIC * Schematic() const
Search the item hierarchy to find a SCHEMATIC.
Definition sch_item.cpp:272
const KIFONT::METRICS & GetFontMetrics() const
Definition sch_item.cpp:783
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:42
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:71
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:76
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:73
int GetSchTextSize() const
Definition sch_textbox.h:78
wxString GetShownText(bool aAllowExtraText, int aDepth=0) const override
Return the string actually shown after processing of the base text.
Definition sch_textbox.h:88
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:54
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:75
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:49
int GetMarginTop() const
Definition sch_textbox.h:74
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:68
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:70
void SetSchTextSize(int aSize)
Definition sch_textbox.h:79
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
void SetMarginTop(int aTop)
Definition sch_textbox.h:69
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:451
@ LAYER_NOTES
Definition layer_ids.h:469
KICAD_T
The set of class identification values stored in EDA_ITEM::m_structType.
Definition typeinfo.h:75
@ SCH_TEXTBOX_T
Definition typeinfo.h:153
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:687