Added a test to wxSocket sample (client side socket event test)

[wxWidgets.git] / src / generic / helphtml.cpp

diff --git a/src/generic/helphtml.cpp b/src/generic/helphtml.cpp
index 0d909968b3b630336d69677fb74fc00d77cab33a..e3425672855779efda748baebbd1fa8dc3af9f74 100644 (file)
--- a/src/generic/helphtml.cpp
+++ b/src/generic/helphtml.cpp
@@ -1,27 +1,50 @@
-/*-*- c++ -*-********************************************************
- * helphtml.cpp - base class for html help systems                  *
- *                                                                  *
- * (C) 1999 by Karsten Ballüder (Ballueder@usa.net)                 *
- *                                                                  *
- * $Id$
- *******************************************************************/
+/////////////////////////////////////////////////////////////////////////////
+// Name:        helphtml.cpp
+// Purpose:     base class for html help systems
+// Author:      Karsten Ballueder
+// Modified by:
+// Created:     04/01/98
+// RCS-ID:      $Id$
+// Copyright:   (c) Karsten Ballueder
+// Licence:     wxWindows licence
+/////////////////////////////////////////////////////////////////////////////
+

 #ifdef __GNUG__
 #   pragma implementation "helphtml.h"
 #endif
 
 #ifdef __GNUG__
 #   pragma implementation "helphtml.h"
 #endif
 

-#include   "wx/setup.h"
-#include   "wx/helpbase.h"
-#include   "wx/generic/helpext.h"
-#include   "wx/string.h"
-#include   "wx/utils.h"
-#include   "wx/list.h"
-#include   "wx/intl.h"
-#include   <stdio.h>
-#include   <ctype.h>
-#include   <sys/stat.h>
-#include   <unistd.h>
+#include "wx/wxprec.h"
+
+#ifdef __BORLANDC__
+    #pragma hdrstop
+#endif

 
 

+#if wxUSE_HELP

 
 

+#ifndef WX_PRECOMP
+    #include "wx/setup.h"
+    #include "wx/string.h"
+    #include "wx/utils.h"
+    #include "wx/list.h"
+    #include "wx/intl.h"
+    #include "wx/msgdlg.h"
+    #include "wx/choicdlg.h"
+#endif
+
+#include "wx/helpbase.h"
+#include "wx/generic/helpext.h"
+
+#include <stdio.h>
+#include <ctype.h>
+#ifndef __MWERKS__
+#include <sys/stat.h>
+#endif
+
+#ifndef __WINDOWS__
+    #include   <unistd.h>
+#endif
+
+#define CONTENTS_ID   0

 
 class wxExtHelpMapEntry : public wxObject
 {
 
 class wxExtHelpMapEntry : public wxObject
 {


@@ -33,29 +56,22 @@ public:
       { id = iid; url = iurl; doc = idoc; }
 };
 
       { id = iid; url = iurl; doc = idoc; }
 };
 

-
-struct wxBusyCursor
-{
-   wxBusyCursor() { wxBeginBusyCursor(); }
-   ~wxBusyCursor() { wxEndBusyCursor(); }
-};
-

 IMPLEMENT_ABSTRACT_CLASS(wxHTMLHelpControllerBase, wxHelpControllerBase)
 IMPLEMENT_ABSTRACT_CLASS(wxHTMLHelpControllerBase, wxHelpControllerBase)

-   
+

 /**
    This class implements help via an external browser.
    It requires the name of a directory containing the documentation
    and a file mapping numerical Section numbers to relative URLS.
 */
 
 /**
    This class implements help via an external browser.
    It requires the name of a directory containing the documentation
    and a file mapping numerical Section numbers to relative URLS.
 */
 

-wxHTMLHelpControllerBase::wxHTMLHelpControllerBase(void)
+wxHTMLHelpControllerBase::wxHTMLHelpControllerBase()

 {
    m_MapList = (wxList*) NULL;
    m_NumOfEntries = 0;
 }
 
 void
 {
    m_MapList = (wxList*) NULL;
    m_NumOfEntries = 0;
 }
 
 void

-wxHTMLHelpControllerBase::DeleteList(void)
+wxHTMLHelpControllerBase::DeleteList()

 {
    if(m_MapList)
    {
 {
    if(m_MapList)
    {


@@ -71,7 +87,7 @@ wxHTMLHelpControllerBase::DeleteList(void)
    }
 }
 
    }
 }
 

-wxHTMLHelpControllerBase::~wxHTMLHelpControllerBase(void)
+wxHTMLHelpControllerBase::~wxHTMLHelpControllerBase()

 {
    DeleteList();
 }
 {
    DeleteList();
 }


@@ -95,7 +111,7 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
    wxString mapFile, file, url, doc;
    int id,i,len;
    char buffer[WXEXTHELP_BUFLEN];
    wxString mapFile, file, url, doc;
    int id,i,len;
    char buffer[WXEXTHELP_BUFLEN];

-   
+

    wxBusyCursor b; // display a busy cursor
 
    if(! ifile.IsEmpty())
    wxBusyCursor b; // display a busy cursor
 
    if(! ifile.IsEmpty())


@@ -103,7 +119,7 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
       file = ifile;
       if(! wxIsAbsolutePath(file))
       {
       file = ifile;
       if(! wxIsAbsolutePath(file))
       {

-         char* f = wxGetWorkingDirectory();
+         wxChar* f = wxGetWorkingDirectory();

          file = f;
          delete[] f; // wxGetWorkingDirectory returns new memory
          file << WXEXTHELP_SEPARATOR << ifile;
          file = f;
          delete[] f; // wxGetWorkingDirectory returns new memory
          file << WXEXTHELP_SEPARATOR << ifile;


@@ -111,6 +127,7 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
       else
          file = ifile;
 
       else
          file = ifile;
 

+#if wxUSE_INTL

       // If a locale is set, look in file/localename, i.e.
       // If passed "/usr/local/myapp/help" and the current wxLocale is
       // set to be "de", then look in "/usr/local/myapp/help/de/"
       // If a locale is set, look in file/localename, i.e.
       // If passed "/usr/local/myapp/help" and the current wxLocale is
       // set to be "de", then look in "/usr/local/myapp/help/de/"


@@ -122,11 +139,21 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
          newfile << WXEXTHELP_SEPARATOR << wxGetLocale()->GetName();
          if(wxDirExists(newfile))
             file = newfile;
          newfile << WXEXTHELP_SEPARATOR << wxGetLocale()->GetName();
          if(wxDirExists(newfile))
             file = newfile;

+         else
+         {
+            newfile = WXEXTHELP_SEPARATOR;
+            const wxChar *cptr = wxGetLocale()->GetName().c_str();
+            while(*cptr && *cptr != _T('_'))
+               newfile << *(cptr++);
+            if(wxDirExists(newfile))
+               file = newfile;
+         }

       }
       }

-      
+#endif
+

       if(! wxDirExists(file))
          return FALSE;
       if(! wxDirExists(file))
          return FALSE;

-      
+

       mapFile << file << WXEXTHELP_SEPARATOR << WXEXTHELP_MAPFILE;
    }
    else // try to reload old file
       mapFile << file << WXEXTHELP_SEPARATOR << WXEXTHELP_MAPFILE;
    }
    else // try to reload old file


@@ -138,8 +165,8 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
    DeleteList();
    m_MapList = new wxList;
    m_NumOfEntries = 0;
    DeleteList();
    m_MapList = new wxList;
    m_NumOfEntries = 0;

-   
-   FILE *input = fopen(mapFile.c_str(),"rt");
+
+   FILE *input = fopen(mapFile.fn_str(),"rt");

    if(! input)
       return FALSE;
    do
    if(! input)
       return FALSE;
    do


@@ -167,21 +194,44 @@ wxHTMLHelpControllerBase::LoadFile(const wxString& ifile)
       }
    }while(! feof(input));
    fclose(input);
       }
    }while(! feof(input));
    fclose(input);

-   
+

    m_MapFile = file; // now it's valid
    return TRUE;
 }
 
 
 bool
    m_MapFile = file; // now it's valid
    return TRUE;
 }
 
 
 bool

-wxHTMLHelpControllerBase::DisplayContents(void)
+wxHTMLHelpControllerBase::DisplayContents()

 {
    if(! m_NumOfEntries)
       return FALSE;
 {
    if(! m_NumOfEntries)
       return FALSE;

-   wxBusyCursor b; // display a busy cursor
-   return KeywordSearch("");
+
+   wxString contents;
+   wxNode *node = m_MapList->First();
+   wxExtHelpMapEntry *entry;
+   while(node)
+   {
+      entry = (wxExtHelpMapEntry *)node->Data();
+      if(entry->id == CONTENTS_ID)
+      {
+         contents = entry->url;
+         break;
+      }
+      node = node->Next();
+   }
+
+   bool rc = FALSE;
+   wxString file;
+   file << m_MapFile << WXEXTHELP_SEPARATOR << contents;
+   if(file.Contains(_T('#')))
+      file = file.BeforeLast(_T('#'));
+   if(contents.Length() && wxFileExists(file))
+      rc = DisplaySection(CONTENTS_ID);
+   
+   // if not found, open homemade toc:
+   return rc ? TRUE : KeywordSearch(_T(""));

 }
 }

-      
+

 bool
 wxHTMLHelpControllerBase::DisplaySection(int sectionNo)
 {
 bool
 wxHTMLHelpControllerBase::DisplaySection(int sectionNo)
 {


@@ -213,38 +263,40 @@ wxHTMLHelpControllerBase::KeywordSearch(const wxString& k)
    if(! m_NumOfEntries)
       return FALSE;
 
    if(! m_NumOfEntries)
       return FALSE;
 

-   wxBusyCursor b; // display a busy cursor

    wxString     *choices = new wxString[m_NumOfEntries];
    wxString     *urls = new wxString[m_NumOfEntries];
    wxString compA, compB;
    wxString     *choices = new wxString[m_NumOfEntries];
    wxString     *urls = new wxString[m_NumOfEntries];
    wxString compA, compB;

-   
+

    int          idx = 0, j;
    bool         rc;
    bool         showAll = k.IsEmpty();
    wxNode       *node = m_MapList->First();
    wxExtHelpMapEntry *entry;
    int          idx = 0, j;
    bool         rc;
    bool         showAll = k.IsEmpty();
    wxNode       *node = m_MapList->First();
    wxExtHelpMapEntry *entry;

-   
-   compA = k; compA.LowerCase(); // we compare case insensitive
-   while(node)
+

    {
    {

-      entry = (wxExtHelpMapEntry *)node->Data();
-      compB = entry->doc; compB.LowerCase();
-      if((showAll || compB.Contains(k)) && ! compB.IsEmpty()) 
+      wxBusyCursor b; // display a busy cursor
+      compA = k; compA.LowerCase(); // we compare case insensitive
+      while(node)

       {
       {

-         urls[idx] = entry->url;
-         // doesn't work:
-         // choices[idx] = (**i).doc.Contains((**i).doc.Before(WXEXTHELP_COMMENTCHAR));
-         //if(choices[idx].IsEmpty()) // didn't contain the ';'
-         //   choices[idx] = (**i).doc;
-         choices[idx] = "";
-         for(j=0;entry->doc.c_str()[j]
-                && entry->doc.c_str()[j] != WXEXTHELP_COMMENTCHAR; j++)
-            choices[idx] << entry->doc.c_str()[j];
-         idx++;
+         entry = (wxExtHelpMapEntry *)node->Data();
+         compB = entry->doc; compB.LowerCase();
+         if((showAll || compB.Contains(k)) && ! compB.IsEmpty())
+         {
+            urls[idx] = entry->url;
+            // doesn't work:
+            // choices[idx] = (**i).doc.Contains((**i).doc.Before(WXEXTHELP_COMMENTCHAR));
+            //if(choices[idx].IsEmpty()) // didn't contain the ';'
+            //   choices[idx] = (**i).doc;
+            choices[idx] = "";
+            for(j=0;entry->doc.c_str()[j]
+                   && entry->doc.c_str()[j] != WXEXTHELP_COMMENTCHAR; j++)
+               choices[idx] << entry->doc.c_str()[j];
+            idx++;
+         }
+         node = node->Next();

       }
       }

-      node = node->Next();

    }
    }

-
+   

    if(idx == 1)
       rc = DisplayHelp(urls[0]);
    else if(idx == 0)
    if(idx == 1)
       rc = DisplayHelp(urls[0]);
    else if(idx == 0)


@@ -264,19 +316,20 @@ wxHTMLHelpControllerBase::KeywordSearch(const wxString& k)
    }
    delete[] urls;
    delete[] choices;
    }
    delete[] urls;
    delete[] choices;

-   
+

    return rc;
 }
 
 
 bool
    return rc;
 }
 
 
 bool

-wxHTMLHelpControllerBase::Quit(void)
+wxHTMLHelpControllerBase::Quit()

 {
    return TRUE;
 }
 
 void
 {
    return TRUE;
 }
 
 void

-wxHTMLHelpControllerBase::OnQuit(void)
+wxHTMLHelpControllerBase::OnQuit()

 {
 }
 
 {
 }
 

+#endif // wxUSE_HELP