400 lines
15 KiB
C++
400 lines
15 KiB
C++
/*
|
|
* 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() );
|
|
}
|