KiCad PCB EDA Suite
Loading...
Searching...
No Matches
symbol_viewer_frame.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 (C) 2016 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright (C) 2008 Wayne Stambaugh <[email protected]>
6 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <https://www.gnu.org/licenses/>.
20 */
21
22
23#ifndef LIB_VIEW_FRAME_H__
24#define LIB_VIEW_FRAME_H__
25
26#include <sch_base_frame.h>
27#include <sch_screen.h>
28#include <tool/selection.h>
29
30class WX_LISTBOX;
31class wxSearchCtrl;
33class LIB_SYMBOL;
34
35
40{
41public:
42
47 SYMBOL_VIEWER_FRAME( KIWAY* aKiway, wxWindow* aParent );
48
50
51 void OnSize( wxSizeEvent& event ) override;
52
56 void ReCreateLibList();
57
61 void ReCreateSymbolList();
62
63 void DisplayLibInfos();
64 void doCloseWindow() override;
65 void CloseLibraryViewer( wxCommandEvent& event );
66
67 void ClickOnLibList( wxCommandEvent& event );
68 void ClickOnSymbolList( wxCommandEvent& event );
69
70 void LoadSettings( APP_SETTINGS_BASE* aCfg ) override;
71 void SaveSettings( APP_SETTINGS_BASE* aCfg ) override;
72
74
75 void CommonSettingsChanged( int aFlags ) override;
76
80 void SetSelectedLibrary( const wxString& aLibName, const wxString& aSubLibName = wxEmptyString );
81
85 void SetSelectedSymbol( const wxString& aSymbolName );
86 void SelectNextSymbol();
88
89 // Accessors:
96 void SetUnitAndBodyStyle( int aUnit, int aBodyStyle );
97 int GetUnit() const { return m_unit; }
98 int GetBodyStyle() const { return m_bodyStyle; }
99
101
102 const BOX2I GetDocumentExtents( bool aIncludeAllVisible = true ) const override;
103
104 SELECTION& GetCurrentSelection() override;
105
106 void KiwayMailIn( KIWAY_MAIL_EVENT& mail ) override;
107
108 void ClearToolbarControl( int aId ) override;
109
110protected:
111 void configureToolbars() override;
112
113 void setupUIConditions() override;
114
115 void doReCreateMenuBar() override;
116
117private:
118 // Set up the tool framework.
119 void setupTools();
120
125 void OnActivate( wxActivateEvent& event );
126
127 void DClickOnSymbolList( wxCommandEvent& event );
128
129 // Rebuild the wxChoice m_unitChoice widget. Must be called after changing the selected symbol
130 void updateUnitChoice();
131 // Rebuild the wxChoice m_bodyStyleChoice widget. Must be called after changing the selected symbol
133
134 void OnLibFilter( wxCommandEvent& aEvent );
135 void OnSymFilter( wxCommandEvent& aEvent );
136 void OnCharHook( wxKeyEvent& aEvent ) override;
137
138 void onSelectSymbolUnit( wxCommandEvent& aEvent );
139 void onSelectSymbolBodyStyle( wxCommandEvent& aEvent );
140
141 void updatePreviewSymbol();
142
143private:
144 wxChoice* m_unitChoice;
146
147 wxSearchCtrl* m_libFilter;
148 WX_LISTBOX* m_libList; // The list of libraries.
149 int m_libListWidth; // Last width of the window.
150
151 wxSearchCtrl* m_symbolFilter;
152 WX_LISTBOX* m_symbolList; // The list of symbols.
153 int m_symbolListWidth; // Last width of the window.
154
155 // Filters to build list of libs/list of symbols.
157 wxArrayString m_allowedLibs;
158
160
161 static int m_unit;
162 static int m_bodyStyle;
163
169
170 std::unique_ptr<LIB_SYMBOL> m_previewItem;
171
172 DECLARE_EVENT_TABLE()
173};
174
175#endif // LIB_VIEW_FRAME_H__
176
BOX2< VECTOR2I > BOX2I
Definition box2.h:914
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
Carry a payload from one KIWAY_PLAYER to another within a PROJECT.
Definition kiway_mail.h:34
A minimalistic software bus for communications between various DLLs/DSOs (DSOs) within the same KiCad...
Definition kiway.h:348
A logical library item identifier and consists of various portions much like a URI.
Definition lib_id.h:45
Define a library symbol object.
Definition lib_symbol.h:114
SCH_BASE_FRAME(KIWAY *aKiway, wxWindow *aParent, FRAME_T aWindowType, const wxString &aTitle, const wxPoint &aPosition, const wxSize &aSize, long aStyle, const wxString &aFrameName)
Helper object to filter a list of libraries.
void OnLibFilter(wxCommandEvent &aEvent)
std::unique_ptr< LIB_SYMBOL > m_previewItem
void ReCreateSymbolList()
Create or recreate the list of symbols in the currently selected library.
void CloseLibraryViewer(wxCommandEvent &event)
void SetSelectedLibrary(const wxString &aLibName, const wxString &aSubLibName=wxEmptyString)
Set the selected library in the library window.
void ClickOnLibList(wxCommandEvent &event)
SYMBOL_VIEWER_FRAME(KIWAY *aKiway, wxWindow *aParent)
void DClickOnSymbolList(wxCommandEvent &event)
void OnActivate(wxActivateEvent &event)
Called when the frame is activated to reload the libraries and symbol lists that can be changed by th...
void OnSymFilter(wxCommandEvent &aEvent)
void setupUIConditions() override
Setup the UI conditions for the various actions and their controls in this frame.
void SetSelectedSymbol(const wxString &aSymbolName)
Set the selected symbol.
void ReCreateLibList()
Create o recreates a sorted list of currently loaded libraries.
SELECTION & GetCurrentSelection() override
Get the current selection from the canvas area.
void ClickOnSymbolList(wxCommandEvent &event)
const BOX2I GetDocumentExtents(bool aIncludeAllVisible=true) const override
Return bounding box of document with option to not include some items.
void ClearToolbarControl(int aId) override
void SetUnitAndBodyStyle(int aUnit, int aBodyStyle)
Set unit and convert, and set flag preventing them from automatically resetting to 1.
wxSearchCtrl * m_symbolFilter
void LoadSettings(APP_SETTINGS_BASE *aCfg) override
Load common frame parameters from a configuration file.
WINDOW_SETTINGS * GetWindowSettings(APP_SETTINGS_BASE *aCfg) override
Return a pointer to the window settings for this frame.
void OnCharHook(wxKeyEvent &aEvent) override
Capture the key event before it is sent to the GUI.
void KiwayMailIn(KIWAY_MAIL_EVENT &mail) override
Receive KIWAY_MAIL_EVENT messages from other players.
LIB_SYMBOL * GetSelectedSymbol() const
void onSelectSymbolUnit(wxCommandEvent &aEvent)
void OnSize(wxSizeEvent &event) override
Recalculate the size of toolbars and display panel when the frame size changes.
void SaveSettings(APP_SETTINGS_BASE *aCfg) override
Save common frame parameters to a configuration data file.
void onSelectSymbolBodyStyle(wxCommandEvent &aEvent)
bool m_selection_changed
Updated to true if a list rewrite on GUI activation resulted in the symbol selection changing,...
void CommonSettingsChanged(int aFlags) override
Notification event that some of the common (suite-wide) settings have changed.
Store the common settings that are saved and loaded for each window / frame.