%% options # __CHANGE__ 001: Correct copyright owner if necessary. copyright owner = $copyrightowner$ # __CHANGE__ 003: Correct copyright year(s) if necessary. copyright year = $year$ # __CHANGE__ 002: Correct license type if necessary. # Use "bsd", "gpl", "lgpl", or "commercial". license = bsd %% header /** @file $application$.h The $application$ class. */ /** Application class, derived from wxApp, one instance per program. */ class $application$ : public wxApp { protected: /** Helper object. */ Dk4WxApplicationHelper *pAh; /** Controller fr online help. */ Dk4WxHelpController *pHc; /* __CHANGE__ 009: Add further members here. */ protected: /** Show error message if there is not enough memory available. */ void ShowMemoryErrorMessage(void); public: /** Application initialization. @return true on success, false on error. */ virtual bool OnInit(); /** Application shutdown. @return 0 on success, any other value indicates an error. */ virtual int OnExit(); }; /** Declaration as the wxApp object. */ DECLARE_APP($application$) /* vim: set ai sw=4 ts=4 : */ %% module #include "$program$.h" $!trace-include /** Localized wxChar texts. */ static wxChar const * $program$_texts[] = { $!string-table macro=wxT # # 0: Menu "File" # File # # 1: Menu item "File/Quit" # Quit # # 2: Tool tip text for menu item "File/Exit" # Exit the application # # 3: Menu "Help" # Help # # 4: Menu item "Help/About" # About # # 5: Tooltip text for menu item "Help/About" # Show version information # # 6: Menu item "Help/Contents" # Contents # # 7: Tooltip text for menu item "Help/Contents" # Open table of contents # # 8: Initial status text # Ready # # 9: Copyright notice. # Copyright (c) # # 10: Dialog box title "About ..." # About # # 11: This program uses the following libraries # This program uses the following libraries: # # 12: See # See: # # 13: __CHANGE__ 015: Text for dummy label, can be reused if lDummy removed. # Dummy text to have at least one label in the frame # # __CHANGE__ 016: Add further texts as required. # $!end }; /** Non-localized wxChar texts. */ static wxChar const * $program$_nl_wx[] = { $!string-table macro=wxT # # 0: Program name. __CHANGE__ 004: Correct program name. # $program$ # # 1: Program version. __CHANGE__ 005: Correct program version. # 1.0.0 # # 2: Copyright owner name. __CHANGE__ 001: Correct copyright owner name. # Copyright owner # # 3: Software vendor name. __CHANGE__ 007: Correct software vendor name # if necessary. Must be one # string without spaces. # SoftwareVendor # # 4: Resource name of Windows icon # aaaaa # # 5: UNUSED (previously Windows chm help file name) # # # 6: UNUSED (previously non-Windows htb help file name) # # # 7: Space # # # 8: Newline # \n # # 9 10 11 12 13 14 15: List of libraries used. # DK tools, wxWidgets, libpng, libjpeg, libtiff, zlib. http://dktools.sourceforge.net http://www.wxwidgets.org http://www.libpng.org/pub/png/libpng.html http://www.ijg.org http://www.remotesensing.org/libtiff http://www.zlib.net # # 16 17 # Error Not enough memory (RAM)! $!end }; /** Non-localized dkChar texts. */ static dkChar const * $program$_nl_dk[] = { $!string-table macro=dkT # # 0: Program group name. __CHANGE__ 006: Correct program group name. # $program$-group # # 1: String table name. # $program$.str # # 2: CHM help file name # $program$.chm # # 3: HTB help file name # $program$.htb $!end }; /** Implementation of the wxApp functionality. */ IMPLEMENT_APP($application$) bool $application$::OnInit() { $frame$ *frame = NULL; wxChar const * const *localizedTexts = NULL; wxPNGHandler *phPng = NULL; wxXPMHandler *phXpm = NULL; wxICOHandler *phIco = NULL; wxArchiveFSHandler *phArchiveFS = NULL; bool back = false; $? "+ $application$::OnInit" /* Initialize members. */ pAh = NULL; pHc = NULL; /* __CHANGE__ 009: Initialize further members here. */ /* Set up helper object. */ pAh = new Dk4WxApplicationHelper(); if (NULL == pAh) { ShowMemoryErrorMessage(); goto finished; } if (!(pAh->Initialize(argv[0], $program$_nl_wx[3], $program$_nl_dk[0]))) { goto finished; } /* Add image and file system handlers for online help. */ phPng = new wxPNGHandler(); if (NULL != phPng) { wxImage::AddHandler(phPng); } else { ShowMemoryErrorMessage(); goto finished; } phXpm = new wxXPMHandler(); if (NULL != phXpm) { wxImage::AddHandler(phXpm); } else { ShowMemoryErrorMessage(); goto finished; } phIco = new wxICOHandler(); if (NULL != phIco) { wxImage::AddHandler(phIco); } else { ShowMemoryErrorMessage(); goto finished; } phArchiveFS = new wxArchiveFSHandler(); if (NULL != phArchiveFS) { wxFileSystem::AddHandler(phArchiveFS); } else { ShowMemoryErrorMessage(); goto finished; } /* Set up help controller. */ pHc = new Dk4WxHelpController(); if (NULL == pHc) { ShowMemoryErrorMessage(); goto finished; } if (!(pHc->Initialize(pAh, $program$_nl_dk[2], $program$_nl_dk[3]))) { goto finished; } /* Attempt to obtain localized texts in users preferred language. */ localizedTexts = pAh->GetStringTable($program$_nl_dk[1], $program$_texts); if(!(localizedTexts)) { localizedTexts = $program$_texts; } /* Create and show frame. */ frame = new $frame$( $frame$_MainWindow, pAh, pHc, argc, argv, localizedTexts, $program$_nl_wx, $program$_nl_dk ); if(!(frame)) { ShowMemoryErrorMessage(); goto finished; } /* Show frame, restore position and indicate success. */ frame->Show(); frame->RestorePosition(); back = true; /* Release resources if initialization failed. */ finished: if(!(back)) { if (NULL != pHc) { pHc->Cleanup(); delete(pHc); pHc = NULL; } if (NULL != pAh) { pAh->Cleanup(); delete(pAh); pAh = NULL; } } $? "- $application$::OnInit %d", (back ? 1 : 0) return back; } int $application$::OnExit() { int back = 0; $? "+ $application$::OnExit" /* __CHANGE__ 009: Release resources allocated by further members. */ /* Release resources. */ if (NULL != pHc) { pHc->Cleanup(); delete(pHc); pHc = NULL; } if (NULL != pAh) { pAh->Cleanup(); delete(pAh); pAh = NULL; } /* __CHANGE__ 010: Set exit status code. */ $? "- $application$::OnExit %d", back return back; } void $application$::ShowMemoryErrorMessage(void) { const wxChar *s_title = NULL; const wxChar *s_text = NULL; if (NULL != pAh) { s_title = pAh->GetBasicString(6); s_text = pAh->GetBasicString(7); } if (NULL == s_title) { s_title = $program$_nl_wx[16]; } if (NULL == s_text) { s_text = $program$_nl_wx[17]; } wxMessageBox(s_text, s_title, (wxOK | wxCENTRE | wxICON_ERROR)); } /* vim: set ai sw=4 ts=4 : */