]> git.saurik.com Git - wxWidgets.git/blobdiff - utils/helpview/src/helpview.cpp
Fixed compile error (seen on OS/2).
[wxWidgets.git] / utils / helpview / src / helpview.cpp
index 0b4aaff796e45fcef058ef33c2c774c66bab5330..22474726a273e0d91be8ab5dbcf69724fa8f9c18 100644 (file)
@@ -27,6 +27,7 @@
 #include "wx/wx.h"
 #endif
 
+#include "wx/filename.h"
 #include "wx/image.h"
 #include "wx/wxhtml.h"
 #include "wx/fs_zip.h"
@@ -34,6 +35,8 @@
 #include "wx/artprov.h"
 #include "wx/filedlg.h"
 
+#include "helpview.h"
+
 class AlternateArtProvider : public wxArtProvider
 {
 protected:
@@ -41,57 +44,209 @@ protected:
                                   const wxSize& size);
 };
 
-// ----------------------------------------------------------------------------
-// private classes
-// ----------------------------------------------------------------------------
-
-
 IMPLEMENT_APP(hvApp)
 
+hvApp::hvApp()
+{
+#if hvUSE_IPC
+    m_server = NULL;
+#endif
+}
 
 bool hvApp::OnInit()
 {
 #ifdef __WXMOTIF__
     delete wxLog::SetActiveTarget(new wxLogStderr); // So dialog boxes aren't used
 #endif
-
+       
     wxArtProvider::PushProvider(new AlternateArtProvider);
-  
-    wxInitAllImageHandlers();
-    wxFileSystem::AddHandler(new wxZipFSHandler);
-
-    SetVendorName("wxWindows");
-    SetAppName("wxHTMLHelp"); 
-    wxConfig::Get(); // create an instance
+       
+#ifdef __WXMAC__
+    wxApp::s_macAboutMenuItemId = wxID_ABOUT;
+    wxFileName::MacRegisterDefaultTypeAndCreator( "htb" , 'HTBD' , 'HTBA' ) ;
+#endif
 
-    help = new wxHtmlHelpController(
-        wxHF_DEFAULT_STYLE|wxHF_FLAT_TOOLBAR|wxHF_OPEN_FILES
-        );
+    int istyle = wxHF_DEFAULT_STYLE;
+       
+    wxString service, windowName, book[10], titleFormat, argStr;
+    int bookCount = 0;
+    int i;
+    bool hasService = FALSE;
+    bool hasWindowName = FALSE;
+    bool createServer = FALSE;
+       
+#if hvUSE_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 < argc; i++ )
+    {
+               argStr = argv[i];
+               
+               if ( argStr.Find( wxT(".hhp") ) >= 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"),
+                       wxOPEN | wxFILE_MUST_EXIST,
+                       NULL);
+               
+               if (!s.IsEmpty())
+               {
+                       book[0] = s;
+                       bookCount = 1;
+               }
+    } 
+#endif
     
-    help->SetTitleFormat(wxT("%s"));
-    if (argc < 2) {
-        if (!OpenBook(help))
-            return FALSE;
+#if hvUSE_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; 
     }
-
-    for (int i = 1; i < argc; i++)
-        help -> AddBook(argv[i]);
-
+       
+#endif  // hvUSE_IPC
+       
+    //now add help
+    wxInitAllImageHandlers();
+    wxFileSystem::AddHandler(new wxZipFSHandler); 
+       
+    SetVendorName(wxT("wxWindows") );
+    SetAppName(wxT("wxHTMLHelpServer") ); 
+    wxConfig::Get(); // create an instance
+       
+    m_helpController = new wxHtmlHelpController( istyle );
+       
+    if ( !hasWindowName )
+        titleFormat = wxT("Help: %s") ;
+    else
+    {
+               //remove underscores
+               windowName.Replace( wxT("_"), wxT(" ") );
+               titleFormat = windowName;
+    }
+       
+    m_helpController->SetTitleFormat( titleFormat );
+       
+    for( i=0; i < bookCount; i++ )
+    {
+        wxFileName fileName(book[i]);
+               m_helpController->AddBook(fileName);
+    }
+       
 #ifdef __WXMOTIF__
     delete wxLog::SetActiveTarget(new wxLogGui);
 #endif
-
-    help -> DisplayContents();
-
+       
+    m_helpController -> DisplayContents();
+       
     return TRUE;
 }
 
 
 int hvApp::OnExit()
 {
-    delete help;
+#if hvUSE_IPC
+    wxNode* node = m_connections.First();
+    while (node)
+    {
+        wxNode* next = node->Next();
+        hvConnection* connection = (hvConnection*) node->Data();
+        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;
 }
 
@@ -102,27 +257,40 @@ 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"),
+               wxOPEN | wxFILE_MUST_EXIST,
+               NULL);
+       
     if (!s.IsEmpty())
     {
         wxString ext = s.Right(4).Lower();
         if (ext == _T(".zip") || ext == _T(".htb") || ext == _T(".hhp"))
         {
             wxBusyCursor bcur;
-            controller->AddBook(s);
+            wxFileName fileName(s);
+            controller->AddBook(fileName);
             return TRUE;
         }
     }
     return FALSE;
 }
 
+#ifdef __WXMAC__
+/// Respond to Apple Event for opening a document
+void hvApp::MacOpenFile(const wxString& filename)
+{
+    wxBusyCursor bcur;
+    wxFileName fileName(filename);
+    m_helpController->AddBook(fileName);
+    m_helpController->DisplayContents();
+}
+#endif
+
+
 /*
- * Art provider class
- */
+* Art provider class
+*/
 
 // ---------------------------------------------------------------------
 // helper macros
@@ -130,48 +298,48 @@ 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);
+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; \
-            } \
-        }
+#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)
+#define GET_STD_ICON_FROM_APP(iconId)
 #endif
 
 // 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(_T(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
@@ -203,26 +371,148 @@ 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_FRAME_ICON,                          helpicon)
-    }
+               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 wxWindows icons not implemented here
+               // will be provided by the default art provider.
+               return wxNullBitmap;
+}
+
+#if hvUSE_IPC
+
+wxConnectionBase *hvServer::OnAcceptConnection(const wxString& topic)
+{
+    if (topic == wxT("HELP"))
+        return new hvConnection();
+    else
+        return NULL;
+}
 
-    //ART(wxART_GO_HOME,                             home)
+// ----------------------------------------------------------------------------
+// hvConnection
+// ----------------------------------------------------------------------------
 
-    // Any wxWindows icons not implemented here
-    // will be provided by the default art provider.
-    return wxNullBitmap;
+hvConnection::hvConnection()
+: wxConnection()
+{
+    wxGetApp().GetConnections().Append(this);
 }
+
+hvConnection::~hvConnection()
+{
+    wxGetApp().GetConnections().DeleteObject(this);
+}
+
+bool hvConnection::OnExecute(const wxString& WXUNUSED(topic),
+                             wxChar *data,
+                             int WXUNUSED(size),
+                             wxIPCFormat WXUNUSED(format))
+{
+       //    wxLogStatus("Execute command: %s", data);
+       
+       if ( !wxStrncmp( data, wxT("--intstring"), 11 ) )
+       {
+        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
+       {
+               wxGetApp().GetHelpController()->Display(data);
+       }
+    
+    return TRUE;
+}
+
+bool hvConnection::OnPoke(const wxString& WXUNUSED(topic),
+                          const wxString& item,
+                          wxChar *data,
+                          int WXUNUSED(size),
+                          wxIPCFormat WXUNUSED(format))
+{
+       //    wxLogStatus("Poke command: %s = %s", item.c_str(), data);
+       //topic is not tested
+       
+       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;
+}
+
+wxChar *hvConnection::OnRequest(const wxString& WXUNUSED(topic),
+                                                               const wxString& WXUNUSED(item),
+                                                               int * WXUNUSED(size),
+                                                               wxIPCFormat WXUNUSED(format))
+{
+    return NULL;
+}
+
+bool hvConnection::OnStartAdvise(const wxString& WXUNUSED(topic),
+                                 const wxString& WXUNUSED(item))
+{
+    return TRUE;
+}
+
+#endif
+    // hvUSE_IPC