diff options
Diffstat (limited to 'common/dialog_about/dialog_about.cpp')
| -rw-r--r-- | common/dialog_about/dialog_about.cpp | 399 |
1 files changed, 399 insertions, 0 deletions
diff --git a/common/dialog_about/dialog_about.cpp b/common/dialog_about/dialog_about.cpp new file mode 100644 index 0000000..e947c87 --- /dev/null +++ b/common/dialog_about/dialog_about.cpp @@ -0,0 +1,399 @@ +/* + * This program source code file is part of KiCad, a free EDA CAD application. + * + * Copyright (C) 2010 Rafael Sokolowski <Rafael.Sokolowski@web.de> + * Copyright (C) 2014 KiCad Developers, see CHANGELOG.TXT for contributors. + * + * This program 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. + * + * This program 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 this program; if not, you may find one here: + * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html + * or you may search the http://www.gnu.org website for the version 2 license, + * or you may write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + */ + +#include <dialog_about.h> + +/////////////////////////////////////////////////////////////////////////////// +/// Class dialog_about methods +/////////////////////////////////////////////////////////////////////////////// + +dialog_about::dialog_about(wxWindow *parent, AboutAppInfo& appInfo) + : dialog_about_base(parent), info(appInfo) +{ + picInformation = KiBitmap( info_xpm ); + picDevelopers = KiBitmap( preference_xpm ); + picDocWriters = KiBitmap( editor_xpm ); + picArtists = KiBitmap( palette_xpm ); + picTranslators = KiBitmap( language_xpm ); + picLicense = KiBitmap( tools_xpm ); + picPackagers = KiBitmap( zip_xpm ); + + m_bitmapApp->SetBitmap( info.GetIcon() ); + + m_staticTextAppTitle->SetLabel( info.GetAppName() ); + m_staticTextCopyright->SetLabel( info.GetCopyright() ); + m_staticTextBuildVersion->SetLabel( info.GetBuildVersion() ); + m_staticTextLibVersion->SetLabel( info.GetLibVersion() ); + + DeleteNotebooks(); + CreateNotebooks(); + + GetSizer()->SetSizeHints( this ); + m_auiNotebook->Update(); + SetFocus(); + Centre(); +} + + +dialog_about::~dialog_about() +{ +} + + +wxFlexGridSizer* dialog_about::CreateFlexGridSizer() +{ + // three columns with vertical and horizontal extra space of two pixels + wxFlexGridSizer* fgSizer1 = new wxFlexGridSizer( 3, 2, 2 ); + fgSizer1->SetFlexibleDirection( wxHORIZONTAL ); + fgSizer1->SetNonFlexibleGrowMode( wxFLEX_GROWMODE_SPECIFIED ); + + return fgSizer1; +} + + +void dialog_about::DeleteNotebooks() +{ + for( size_t i=0; i<m_auiNotebook->GetPageCount(); ++i ) + m_auiNotebook->DeletePage( i ); +} + + +void dialog_about::CreateNotebooks() +{ + CreateNotebookHtmlPage( m_auiNotebook, _( "Information" ), picInformation, + info.GetDescription() ); + + CreateNotebookPage( m_auiNotebook, _( "Developers" ) , picDevelopers, info.GetDevelopers() ); + CreateNotebookPage( m_auiNotebook, _( "Doc Writers" ), picDocWriters, info.GetDocWriters() ); + + CreateNotebookPageByCategory( m_auiNotebook, _( "Artists" ), picArtists, info.GetArtists() ); + CreateNotebookPageByCategory( m_auiNotebook, _( "Translators" ), picTranslators, + info.GetTranslators() ); + CreateNotebookPageByCategory( m_auiNotebook, _( "Packagers" ), picPackagers, + info.GetPackagers() ); + + CreateNotebookHtmlPage( m_auiNotebook, _( "License" ), picLicense, info.GetLicense() ); +} + +void dialog_about::CreateNotebookPage( wxAuiNotebook* parent, const wxString& caption, + const wxBitmap& icon, const Contributors& contributors ) +{ + wxBoxSizer* bSizer = new wxBoxSizer( wxHORIZONTAL ); + + wxScrolledWindow* m_scrolledWindow1 = new wxScrolledWindow( parent, wxID_ANY, + wxDefaultPosition, + wxDefaultSize, + wxHSCROLL|wxVSCROLL ); + m_scrolledWindow1->SetScrollRate( 5, 5 ); + + /* Panel for additional space at the left, + * but can also be used to show an additional bitmap. + */ + wxPanel* panel1 = new wxPanel( m_scrolledWindow1 ); + + wxFlexGridSizer* fgSizer1 = CreateFlexGridSizer(); + + for( size_t i=0; i<contributors.GetCount(); ++i ) + { + Contributor* contributor = &contributors.Item( i ); + + // Icon at first column + wxStaticBitmap* m_bitmap1 = CreateStaticBitmap( m_scrolledWindow1, contributor->GetIcon() ); + fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 ); + + // Name of contributor at second column + if ( contributor->GetName() != wxEmptyString ) + { + wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY, + contributor->GetName(), + wxDefaultPosition, wxDefaultSize, 0 ); + m_staticText1->Wrap( -1 ); + fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + } + else + { + fgSizer1->AddSpacer( 5 ); + } + + // Email address of contributor at third column + if ( contributor->GetEMail() != wxEmptyString ) + { + wxHyperlinkCtrl* hyperlink = CreateHyperlink( m_scrolledWindow1, + contributor->GetEMail() ); + fgSizer1->Add( hyperlink, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + } + else + { + fgSizer1->AddSpacer( 5 ); + } + } + + bSizer->Add( panel1, 1, wxEXPAND|wxALL, 10 ); + bSizer->Add( fgSizer1, 7, wxEXPAND|wxALL, 10 ); // adjust width of panel with first int value + m_scrolledWindow1->SetSizer( bSizer ); + m_scrolledWindow1->Layout(); + bSizer->Fit( m_scrolledWindow1 ); + parent->AddPage( m_scrolledWindow1, caption, false, icon ); +} + + +void dialog_about::CreateNotebookPageByCategory(wxAuiNotebook* parent, const wxString& caption, + const wxBitmap& icon, + const Contributors& contributors) +{ + wxBoxSizer* bSizer = new wxBoxSizer( wxHORIZONTAL ); + + wxScrolledWindow* m_scrolledWindow1 = new wxScrolledWindow( parent, wxID_ANY, + wxDefaultPosition, + wxDefaultSize, + wxHSCROLL|wxVSCROLL ); + m_scrolledWindow1->SetScrollRate( 5, 5 ); + + /* Panel for additional space at the left, + * but can also be used to show an additional bitmap. + */ + wxPanel* panel1 = new wxPanel( m_scrolledWindow1 ); + + wxFlexGridSizer* fgSizer1 = CreateFlexGridSizer(); + + for( size_t i=0; i<contributors.GetCount(); ++i ) + { + Contributor* contributor = &contributors.Item( i ); + + wxBitmap* icon = contributor->GetIcon(); + wxString category = contributor->GetCategory(); + + /* to construct the next row we expect to have + * a category and a contributor that was not considered up to now + */ + if( ( category != wxEmptyString ) && !( contributor->IsChecked() ) ) + { + // Icon at first column + wxStaticBitmap* m_bitmap1 = CreateStaticBitmap( m_scrolledWindow1, icon ); + fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 ); + + // Category name at second column + wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY, + contributor->GetCategory() + wxT( ":" ), + wxDefaultPosition, wxDefaultSize, 0 ); + m_staticText1->SetFont( wxFont( wxNORMAL_FONT->GetPointSize(), 70, 90, 92, false, + wxEmptyString ) ); // bold font + m_staticText1->Wrap( -1 ); + fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + + // Nothing at third column + fgSizer1->AddSpacer( 5 ); + + // Now, all contributors of the same category will follow + for( size_t j=0; j<contributors.GetCount(); ++j ) + { + Contributor* contributor = &contributors.Item( j ); + + if ( contributor->GetCategory() == category ) + { + // First column is empty + fgSizer1->AddSpacer(5); + + // Name of contributor at second column + wxStaticText* m_staticText2 = new wxStaticText( m_scrolledWindow1, wxID_ANY, + wxT(" • ") + contributor->GetName(), + wxDefaultPosition, + wxDefaultSize, 0 ); + m_staticText1->Wrap( -1 ); + fgSizer1->Add( m_staticText2, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + + // Email address of contributor at third column + if( contributor->GetEMail() != wxEmptyString ) + { + wxHyperlinkCtrl* hyperlink = CreateHyperlink( m_scrolledWindow1, + contributor->GetEMail() ); + fgSizer1->Add( hyperlink, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + } + else + { + fgSizer1->AddSpacer( 5 ); + } + + /* this contributor was added to the GUI, + * thus can be ignored next time + */ + contributor->SetChecked( true ); + } + } + } + else + { + continue; + } + } + + /* Now, lets list the remaining contributors that have not been considered + * because they were not assigned to any category. + */ + for ( size_t k=0; k<contributors.GetCount(); ++k ) + { + Contributor* contributor = &contributors.Item( k ); + + if ( contributor->IsChecked() ) + continue; + + // Icon at first column + wxStaticBitmap* m_bitmap1 = CreateStaticBitmap( m_scrolledWindow1, contributor->GetIcon() ); + fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 ); + + // Name of contributor at second column + if( contributor->GetName() != wxEmptyString ) + { + wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY, + contributor->GetName(), + wxDefaultPosition, wxDefaultSize, 0 ); + m_staticText1->Wrap( -1 ); + fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + } + else + { + fgSizer1->AddSpacer( 5 ); + } + + // Email address of contributor at third column + if ( contributor->GetEMail() != wxEmptyString ) + { + wxHyperlinkCtrl* hyperlink = CreateHyperlink( m_scrolledWindow1, + contributor->GetEMail() ); + fgSizer1->Add( hyperlink, 0, wxALIGN_LEFT|wxBOTTOM, 2 ); + } + else + { + fgSizer1->AddSpacer( 5 ); + } + } + + bSizer->Add( panel1, 1, wxEXPAND|wxALL, 10 ); + bSizer->Add( fgSizer1, 7, wxEXPAND|wxALL, 10 ); // adjust width of panel with first int value + m_scrolledWindow1->SetSizer( bSizer ); + m_scrolledWindow1->Layout(); + bSizer->Fit( m_scrolledWindow1 ); + parent->AddPage( m_scrolledWindow1, caption, false, icon ); +} + + +void dialog_about::CreateNotebookHtmlPage( wxAuiNotebook* parent, const wxString& caption, + const wxBitmap& icon, const wxString& html ) +{ + wxPanel* panel = new wxPanel( parent, wxID_ANY, wxDefaultPosition, wxDefaultSize, + wxTAB_TRAVERSAL ); + + wxBoxSizer* bSizer = new wxBoxSizer( wxVERTICAL ); + + wxString htmlPage = wxEmptyString, htmlContent = html; + + // to have a unique look background color for HTML pages is set to the default as it is + // used for all the other widgets + wxString htmlColor = ( this->GetBackgroundColour() ).GetAsString( wxC2S_HTML_SYNTAX ); + + // beginning of HTML structure + htmlPage.Append( wxT( "<html><body bgcolor='" ) + htmlColor + wxT( "'>" ) ); + + htmlPage.Append( htmlContent ); + + // end of HTML structure indicated by closing tags + htmlPage.Append( wxT( "</body></html>" ) ); + + // the HTML page is going to be created with previously created HTML content + wxHtmlWindow* htmlWindow = new wxHtmlWindow( panel, wxID_ANY, wxDefaultPosition, wxDefaultSize, + wxHW_SCROLLBAR_AUTO|wxHW_NO_SELECTION ); + + // HTML font set to font properties as they are used for widgets to have an unique look + // under different platforms with HTML + wxFont font = this->GetFont(); + htmlWindow->SetStandardFonts( font.GetPointSize(), font.GetFaceName(), font.GetFaceName() ); + htmlWindow->SetPage( htmlPage ); + + // the HTML window shall not be used to open external links, thus this task is delegated + // to users default browser + htmlWindow->Connect( wxEVT_COMMAND_HTML_LINK_CLICKED, + wxHtmlLinkEventHandler( dialog_about::OnHtmlLinkClicked ), NULL, this ); + + // no additional space around the HTML window as it is also the case by the other notebook pages + bSizer->Add( htmlWindow, 1, wxALL|wxEXPAND, 0 ); + panel->SetSizer( bSizer ); + panel->Layout(); + bSizer->Fit( panel ); + parent->AddPage( panel, caption, false, icon ); +} + + +wxHyperlinkCtrl* dialog_about::CreateHyperlink(wxScrolledWindow* parent, const wxString& email) +{ + wxHyperlinkCtrl* hyperlink = new wxHyperlinkCtrl( + parent, wxID_ANY, + wxT( "<" ) + email + wxT( ">" ), /* the label */ + wxT( "mailto:" ) + email + + wxT( "?subject=KiCad - " ) + + info.GetBuildVersion() + + wxT( " , " ) + info.GetLibVersion() + ); /* the url */ + + return hyperlink; +} + + +wxStaticBitmap* dialog_about::CreateStaticBitmap(wxScrolledWindow* parent, wxBitmap* icon) +{ + wxStaticBitmap* bitmap = new wxStaticBitmap( parent, wxID_ANY, wxNullBitmap, + wxDefaultPosition, wxDefaultSize, 0 ); + + if( icon ) + { + bitmap->SetBitmap( *icon ); + } + else + { + bitmap->SetBitmap( KiBitmap( right_xpm ) ); + } + + return bitmap; +} + + +/////////////////////////////////////////////////////////////////////////////// +/// Event handlers +/////////////////////////////////////////////////////////////////////////////// + +void dialog_about::OnClose( wxCloseEvent &event ) +{ + Destroy(); +} + + +void dialog_about::OnOkClick( wxCommandEvent &event ) +{ + Destroy(); +} + + +void dialog_about::OnHtmlLinkClicked( wxHtmlLinkEvent& event ) +{ + ::wxLaunchDefaultBrowser( event.GetLinkInfo().GetHref() ); +} |