X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/877c86a2f2d6012e9230d8e6de67e73066256a3e..e90d566109362e04b65394a0c053f33f156bdaaf:/utils/helpview/src/helpview.cpp diff --git a/utils/helpview/src/helpview.cpp b/utils/helpview/src/helpview.cpp index a3ab521e75..4b445e0065 100644 --- a/utils/helpview/src/helpview.cpp +++ b/utils/helpview/src/helpview.cpp @@ -5,15 +5,10 @@ // Author: Vaclav Slavik, Julian Smart // Modified by: // Created: 2002-07-09 -// RCS-ID: $Id$ // Copyright: (c) 2002 Vaclav Slavik, Julian Smart and others // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// -#ifdef __GNUG__ -#pragma implementation "help.cpp" -#endif - // For compilers that support precompilation, includes "wx/wx.h". #include "wx/wxprec.h" @@ -22,11 +17,12 @@ #endif // for all others, include the necessary headers (this file is usually all you -// need because it includes almost all "standard" wxWindows headers +// need because it includes almost all "standard" wxWidgets headers #ifndef WX_PRECOMP #include "wx/wx.h" #endif +#include "wx/filename.h" #include "wx/image.h" #include "wx/wxhtml.h" #include "wx/fs_zip.h" @@ -43,13 +39,14 @@ protected: const wxSize& size); }; -// ---------------------------------------------------------------------------- -// private classes -// ---------------------------------------------------------------------------- - - IMPLEMENT_APP(hvApp) +hvApp::hvApp() +{ +#if wxUSE_IPC + m_server = NULL; +#endif +} bool hvApp::OnInit() { @@ -57,41 +54,196 @@ bool hvApp::OnInit() delete wxLog::SetActiveTarget(new wxLogStderr); // So dialog boxes aren't used #endif - wxArtProvider::PushProvider(new AlternateArtProvider); - + wxArtProvider::Push(new AlternateArtProvider); + +#if defined( __WXOSX_MAC__ ) && wxOSX_USE_CARBON + wxApp::s_macAboutMenuItemId = wxID_ABOUT; + wxFileName::MacRegisterDefaultTypeAndCreator( wxT("htb") , 'HTBD' , 'HTBA' ) ; +#endif + + int istyle = wxHF_DEFAULT_STYLE; + + wxString service, windowName, titleFormat, argStr; + wxString book[10]; + int bookCount = 0; + int i; + bool hasService = false; + bool hasWindowName = false; + bool createServer = false; + +#if wxUSE_IPC + m_server = NULL; +#endif + + // Help books are recognized by extension ".hhp" ".htb" or ".zip". + // Service and window_name can occur anywhere in arguments, + // but service must be first + // Other arguments (topic?) could be added + + // modes of operation: + // 1) no arguments - stand alone, prompt user for book + // 2) books only - stand alone, open books + // 3) "--server" as (any) arg - start connection with default service; + // also open any books passed as other arguments + // 4) at least one argument which is not book, and not "--server" - take first + // such argument as service, second (if present) as window name, + // start service, open any books + + for( i=1; i= 0 + || argStr.Find( wxT(".htb") ) >= 0 + || argStr.Find( wxT(".zip") ) >= 0 ) + { + book[bookCount] = argStr; + bookCount++; + } + else if ( argStr == wxT("--server") ) + { + createServer = true; +#if defined(__WXMSW__) + service = wxT("generic_helpservice"); +#elif defined(__UNIX__) + service = wxT("/tmp/") + wxString(wxT("generic_helpservice")); +#else + service = wxT("4242"); +#endif + } + else if ( !hasService ) + { + service = argStr; + hasService = true; + createServer = true; + } + else if ( !hasWindowName ) + { + windowName = argStr; + hasWindowName = true; + } + else if ( argStr.Find( wxT("--Style") ) >= 0 ) + { + long i; + wxString numb = argStr.AfterLast(wxT('e')); + if ( !(numb.ToLong(&i) ) ) + { + wxLogError( wxT("Integer conversion failed for --Style") ); + } + else + { + istyle = i; + } + } + else + { + //unknown - could be topic? + } + } + + // No book - query user; but not on Mac, since there + // may be an AppleEvent to open a document on the way +#ifndef __WXMAC__ + if ( bookCount < 1 ) + { + wxString s = wxFileSelector( wxT("Open help file"), + wxGetCwd(), + wxEmptyString, + wxEmptyString, + wxT("Help books (*.htb)|*.htb|Help books (*.zip)|*.zip|HTML Help Project (*.hhp)|*.hhp"), + wxFD_OPEN | wxFD_FILE_MUST_EXIST, + NULL); + + if (!s.empty()) + { + book[0] = s; + bookCount = 1; + } + } +#endif + +#if wxUSE_IPC + + if ( createServer ) + { + // Create a new server + m_server = new hvServer; + + if ( !m_server->Create(service) ) + { + wxString wxm = wxT("Server Create failed - service: "); + wxString xxm = wxm << service; + wxLogError( xxm ); + //if MSW quits here, probably another copy already exists + return false; + } + createServer = false; + wxUnusedVar(createServer); + } + +#endif // wxUSE_IPC + + //now add help wxInitAllImageHandlers(); wxFileSystem::AddHandler(new wxZipFSHandler); - SetVendorName("wxWindows"); - SetAppName("wxHTMLHelp"); + SetVendorName(wxT("wxWidgets") ); + SetAppName(wxT("wxHTMLHelpServer") ); wxConfig::Get(); // create an instance - help = new wxHtmlHelpController( - wxHF_DEFAULT_STYLE|wxHF_FLAT_TOOLBAR|wxHF_OPEN_FILES - ); - - help->SetTitleFormat(wxT("%s")); - if (argc < 2) { - if (!OpenBook(help)) - return FALSE; + m_helpController = new wxHtmlHelpController( istyle ); + + if ( !hasWindowName ) + { + titleFormat = wxT("Help: %s") ; + } + else + { + //remove underscores + windowName.Replace( wxT("_"), wxT(" ") ); + titleFormat = windowName; } - for (int i = 1; i < argc; i++) - help -> AddBook(argv[i]); + m_helpController->SetTitleFormat( titleFormat ); + + for( i=0; iAddBook(fileName); + } #ifdef __WXMOTIF__ delete wxLog::SetActiveTarget(new wxLogGui); #endif - help -> DisplayContents(); + m_helpController->DisplayContents(); - return TRUE; + return true; } int hvApp::OnExit() { - delete help; +#if wxUSE_IPC + wxObjectList::compatibility_iterator node = m_connections.GetFirst(); + while (node) + { + wxObjectList::compatibility_iterator next = node->GetNext(); + hvConnection* connection = (hvConnection*) node->GetData(); + connection->Disconnect(); + delete connection; + node = next; + } + m_connections.Clear(); + + if (m_server) + { + delete m_server; + m_server = NULL; + } +#endif + + delete m_helpController; delete wxConfig::Set(NULL); return 0; @@ -104,27 +256,41 @@ bool hvApp::OpenBook(wxHtmlHelpController* controller) wxEmptyString, wxEmptyString, _( -"Help books (*.htb)|*.htb|Help books (*.zip)|*.zip|\ -HTML Help Project (*.hhp)|*.hhp"), - wxOPEN | wxFILE_MUST_EXIST, - NULL); + "Help books (*.htb)|*.htb|Help books (*.zip)|*.zip|\ + HTML Help Project (*.hhp)|*.hhp"), + wxFD_OPEN | wxFD_FILE_MUST_EXIST, + NULL); - if (!s.IsEmpty()) + if ( !s.empty() ) { wxString ext = s.Right(4).Lower(); - if (ext == _T(".zip") || ext == _T(".htb") || ext == _T(".hhp")) + if (ext == wxT(".zip") || ext == wxT(".htb") || ext == wxT(".hhp")) { wxBusyCursor bcur; - controller->AddBook(s); - return TRUE; + wxFileName fileName(s); + controller->AddBook(fileName); + return true; } } - return FALSE; + + return false; } +#ifdef __WXMAC__ +/// Respond to Apple Event for opening a document +void hvApp::MacOpenFiles(const wxArrayString& fileNames) +{ + wxBusyCursor bcur; + wxFileName fileName(fileNames[0]); + m_helpController->AddBook(fileName); + m_helpController->DisplayContents(); +} +#endif + + /* - * Art provider class - */ +* Art provider class +*/ // --------------------------------------------------------------------- // helper macros @@ -132,48 +298,33 @@ HTML Help Project (*.hhp)|*.hhp"), // Standard macro for getting a resource from XPM file: #define ART(artId, xpmRc) \ - if ( id == artId ) return wxBitmap(xpmRc##_xpm); - -// Compatibility hack to use wxApp::GetStdIcon of overriden by the user -#if WXWIN_COMPATIBILITY_2_2 - #define GET_STD_ICON_FROM_APP(iconId) \ - if ( client == wxART_MESSAGE_BOX ) \ - { \ - wxIcon icon = wxTheApp->GetStdIcon(iconId); \ - if ( icon.Ok() ) \ - { \ - wxBitmap bmp; \ - bmp.CopyFromIcon(icon); \ - return bmp; \ - } \ - } -#else - #define GET_STD_ICON_FROM_APP(iconId) -#endif +if ( id == artId ) return wxBitmap(xpmRc##_xpm); + +#define GET_STD_ICON_FROM_APP(iconId) // There are two ways of getting the standard icon: either via XPMs or via // wxIcon ctor. This depends on the platform: #if defined(__WXUNIVERSAL__) - #define CREATE_STD_ICON(iconId, xpmRc) return wxNullBitmap; +#define CREATE_STD_ICON(iconId, xpmRc) return wxNullBitmap; #elif defined(__WXGTK__) || defined(__WXMOTIF__) - #define CREATE_STD_ICON(iconId, xpmRc) return wxBitmap(xpmRc##_xpm); +#define CREATE_STD_ICON(iconId, xpmRc) return wxBitmap(xpmRc##_xpm); #else - #define CREATE_STD_ICON(iconId, xpmRc) \ - { \ - wxIcon icon(_T(iconId)); \ - wxBitmap bmp; \ - bmp.CopyFromIcon(icon); \ - return bmp; \ - } +#define CREATE_STD_ICON(iconId, xpmRc) \ +{ \ + wxIcon icon(wxT(iconId)); \ + wxBitmap bmp; \ + bmp.CopyFromIcon(icon); \ + return bmp; \ +} #endif // Macro used in CreateBitmap to get wxICON_FOO icons: #define ART_MSGBOX(artId, iconId, xpmRc) \ if ( id == artId ) \ - { \ - GET_STD_ICON_FROM_APP(iconId) \ - CREATE_STD_ICON(#iconId, xpmRc) \ - } +{ \ + GET_STD_ICON_FROM_APP(iconId) \ + CREATE_STD_ICON(#iconId, xpmRc) \ +} // --------------------------------------------------------------------- // XPMs with the art @@ -205,26 +356,135 @@ wxBitmap AlternateArtProvider::CreateBitmap(const wxArtID& id, const wxSize& WXUNUSED(size)) { ART(wxART_HELP_SIDE_PANEL, helpsidepanel) - ART(wxART_HELP_SETTINGS, helpoptions) - ART(wxART_HELP_BOOK, helpbook) - ART(wxART_HELP_FOLDER, helpbook) - ART(wxART_HELP_PAGE, helppage) - //ART(wxART_ADD_BOOKMARK, addbookm) - //ART(wxART_DEL_BOOKMARK, delbookm) - ART(wxART_GO_BACK, helpback) - ART(wxART_GO_FORWARD, helpforward) - ART(wxART_GO_UP, helpup) - ART(wxART_GO_DOWN, helpdown) - ART(wxART_GO_TO_PARENT, helpuplevel) - ART(wxART_FILE_OPEN, helpopen) - if (client == wxART_HELP_BROWSER) + ART(wxART_HELP_SETTINGS, helpoptions) + ART(wxART_HELP_BOOK, helpbook) + ART(wxART_HELP_FOLDER, helpbook) + ART(wxART_HELP_PAGE, helppage) + //ART(wxART_ADD_BOOKMARK, addbookm) + //ART(wxART_DEL_BOOKMARK, delbookm) + ART(wxART_GO_BACK, helpback) + ART(wxART_GO_FORWARD, helpforward) + ART(wxART_GO_UP, helpup) + ART(wxART_GO_DOWN, helpdown) + ART(wxART_GO_TO_PARENT, helpuplevel) + ART(wxART_FILE_OPEN, helpopen) + if (client == wxART_HELP_BROWSER) + { + //ART(wxART_FRAME_ICON, helpicon) + ART(wxART_HELP, helpicon) + } + + //ART(wxART_GO_HOME, home) + + // Any wxWidgets icons not implemented here + // will be provided by the default art provider. + return wxNullBitmap; +} + +#if wxUSE_IPC + +wxConnectionBase *hvServer::OnAcceptConnection(const wxString& topic) +{ + if (topic == wxT("HELP")) + return new hvConnection(); + else + return NULL; +} + +// ---------------------------------------------------------------------------- +// hvConnection +// ---------------------------------------------------------------------------- + +hvConnection::hvConnection() +: wxConnection() +{ + wxGetApp().GetConnections().Append(this); +} + +hvConnection::~hvConnection() +{ + wxGetApp().GetConnections().DeleteObject(this); +} + +bool hvConnection::OnExec(const wxString& WXUNUSED(topic), + const wxString& data) +{ + // wxLogStatus("Execute command: %s", data); + + if ( data == "--intstring" ) + { + long i; + wxString argStr = data; + wxString numb = argStr.AfterLast(wxT('g')); + if ( !(numb.ToLong(&i) ) ) + { + wxLogError( wxT("Integer conversion failed for --intstring") ); + } + else + { + wxGetApp().GetHelpController()->Display(int(i)); + } + } + else { - ART(wxART_FRAME_ICON, helpicon) + wxGetApp().GetHelpController()->Display(data); } - //ART(wxART_GO_HOME, home) + return true; +} + +bool hvConnection::OnPoke(const wxString& WXUNUSED(topic), + const wxString& item, + const void *buf, + size_t size, + wxIPCFormat format) +{ + const wxString data = GetTextFromData(buf, size, format); + + // wxLogStatus("Poke command: %s = %s", item.c_str(), data); + //topic is not tested - // Any wxWindows icons not implemented here - // will be provided by the default art provider. - return wxNullBitmap; + if ( wxGetApp().GetHelpController() ) + { + if ( item == wxT("--AddBook") ) + { + wxGetApp().GetHelpController()->AddBook(data); + } + else if ( item == wxT("--DisplayContents") ) + { + wxGetApp().GetHelpController()->DisplayContents(); + } + else if ( item == wxT("--DisplayIndex") ) + { + wxGetApp().GetHelpController()->DisplayIndex(); + } + else if ( item == wxT("--KeywordSearch") ) + { + wxGetApp().GetHelpController()->KeywordSearch(data); + } + else if ( item == wxT("--SetTitleFormat") ) + { + wxString newname = data; + newname.Replace( wxT("_"), wxT(" ") ); + wxGetApp().GetHelpController()->SetTitleFormat(newname); + //does not redraw title bar? + //wxGetApp().GetHelpController()->ReFresh(); - or something + } + else if ( item == wxT("--SetTempDir") ) + { + wxGetApp().GetHelpController()->SetTempDir(data); + } + else if ( item == wxT("--YouAreDead") ) + { + // don't really know how to kill app from down here... + // use wxKill from client instead + //wxWindow *win = wxTheApp->GetTopWindow(); + //if ( win ) + // win->Destroy(); + } + } + + return true; } + +#endif // #if wxUSE_IPC