]> git.saurik.com Git - wxWidgets.git/commitdiff
Added USE_ALTERNATE_UI symbol to helpview.cpp.
authorJulian Smart <julian@anthemion.co.uk>
Sun, 7 Jul 2002 21:48:30 +0000 (21:48 +0000)
committerJulian Smart <julian@anthemion.co.uk>
Sun, 7 Jul 2002 21:48:30 +0000 (21:48 +0000)
Set to 1 to:

- provide different icons.
- add an open file icon for the toolbar.
- use a flat toolbar style.
- show a file selector if no file was given on the command line.
- remove 'Help:' from the title bar.

Set to 0 to revert to previous behaviour.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16074 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

14 files changed:
samples/html/helpview/bitmaps/helpback.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpbook.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpdown.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpforward.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpicon.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpopen.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpoptions.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helppage.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpsidepanel.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpup.xpm [new file with mode: 0644]
samples/html/helpview/bitmaps/helpuplevel.xpm [new file with mode: 0644]
samples/html/helpview/helpview.cpp
samples/html/helpview/helpview.ico [new file with mode: 0644]
samples/html/helpview/helpview.rc

diff --git a/samples/html/helpview/bitmaps/helpback.xpm b/samples/html/helpview/bitmaps/helpback.xpm
new file mode 100644 (file)
index 0000000..c7b0991
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */\r
+static char * helpback_xpm[] = {\r
+"16 15 3 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"                ",\r
+"                ",\r
+"      .         ",\r
+"     ..         ",\r
+"    .X.         ",\r
+"   .XX........  ",\r
+"  .XXXXXXXXXX.  ",\r
+" .XXXXXXXXXXX.  ",\r
+" .XXXXXXXXXXX.  ",\r
+"  .XXXXXXXXXX.  ",\r
+"   .XX........  ",\r
+"    .X.         ",\r
+"     ..         ",\r
+"      .         ",\r
+"                "};\r
diff --git a/samples/html/helpview/bitmaps/helpbook.xpm b/samples/html/helpview/bitmaps/helpbook.xpm
new file mode 100644 (file)
index 0000000..4f56093
--- /dev/null
@@ -0,0 +1,25 @@
+/* XPM */\r
+static char * helpbook_xpm[] = {\r
+"16 16 6 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c #000080",\r
+"o     c #c0c0c0",\r
+"O     c #808080",\r
+"+     c Gray100",\r
+"                ",\r
+"       ..       ",\r
+"     ..XX.      ",\r
+"   ..XXXXX.     ",\r
+" ..XXXXXXXX.    ",\r
+".oXXXXXXXXXX.   ",\r
+".XoXXXXXXXXXX.  ",\r
+".XXoXXXXXXXXXX. ",\r
+".XXXoXXXXXXXXX..",\r
+".XXXXoXXXXXX..O ",\r
+" .XXXXoXXX..O+O ",\r
+"  .XXXXo..O++o..",\r
+"   .XXX.O+++o.. ",\r
+"    .XX.o+o..   ",\r
+"     .X.o..     ",\r
+"      ...       "};\r
diff --git a/samples/html/helpview/bitmaps/helpdown.xpm b/samples/html/helpview/bitmaps/helpdown.xpm
new file mode 100644 (file)
index 0000000..30da826
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */\r
+static char * helpdown_xpm[] = {\r
+"16 15 3 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"                ",\r
+"     ......     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"  ....XXXX....  ",\r
+"   .XXXXXXXX.   ",\r
+"    .XXXXXX.    ",\r
+"     .XXXX.     ",\r
+"      .XX.      ",\r
+"       ..       ",\r
+"                "};\r
diff --git a/samples/html/helpview/bitmaps/helpforward.xpm b/samples/html/helpview/bitmaps/helpforward.xpm
new file mode 100644 (file)
index 0000000..3d0b8e5
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */\r
+static char * helpforward_xpm[] = {\r
+"16 15 3 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"                ",\r
+"                ",\r
+"         .      ",\r
+"         ..     ",\r
+"         .X.    ",\r
+"  ........XX.   ",\r
+"  .XXXXXXXXXX.  ",\r
+"  .XXXXXXXXXXX. ",\r
+"  .XXXXXXXXXXX. ",\r
+"  .XXXXXXXXXX.  ",\r
+"  ........XX.   ",\r
+"         .X.    ",\r
+"         ..     ",\r
+"         .      ",\r
+"                "};\r
diff --git a/samples/html/helpview/bitmaps/helpicon.xpm b/samples/html/helpview/bitmaps/helpicon.xpm
new file mode 100644 (file)
index 0000000..b6f57a1
--- /dev/null
@@ -0,0 +1,41 @@
+/* XPM */\r
+static char * helpicon_xpm[] = {\r
+"32 32 6 1",\r
+"      c None",\r
+".     c #808080",\r
+"X     c Black",\r
+"o     c #c0c0c0",\r
+"O     c Gray100",\r
+"+     c #000080",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                .......X        ",\r
+"             ...ooooooo.X       ",\r
+"       o.....XoooOoOOOOoX       ",\r
+"      .oOoOoO.ooOoOoOOOO.X      ",\r
+"  o.o.oOoOoOoO.ooOoOoOOOOX      ",\r
+"  +oOoOoOoOOOOXoooOoOOOOOoX     ",\r
+"   +oOoOoOoOOOO.oooOoOOOOOX     ",\r
+"   +OoOoOoOOOOOXooOoOoOOOOoX    ",\r
+"   o+OoOoOoOOOOO.ooOoOoOOOO.X   ",\r
+"   o+oOoOoOoOOOOXoooOoOOOOOOX   ",\r
+"    o+oOoOoOoOOOO.oooOooOOOooX  ",\r
+"    o+OoOoOoOOOOOXooOo...oooX+  ",\r
+"     o+OoOoOoOOoooXooXXXXXXX++  ",\r
+"      o+OoOoOo.o.oXXX++++++++.  ",\r
+"      o+oOoOo.oXXX+++......     ",\r
+"       o+oOoXXX+++.+            ",\r
+"       o+OXX+++...              ",\r
+"        o+++...                 ",\r
+"        o+..                    ",\r
+"         o.                     ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                ",\r
+"                                "};\r
diff --git a/samples/html/helpview/bitmaps/helpopen.xpm b/samples/html/helpview/bitmaps/helpopen.xpm
new file mode 100644 (file)
index 0000000..13e3550
--- /dev/null
@@ -0,0 +1,22 @@
+/* XPM */\r
+static char * helpopen_xpm[] = {\r
+"16 15 4 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"o     c #848484",\r
+"                ",\r
+"                ",\r
+"                ",\r
+"  ...           ",\r
+" .XXX.......    ",\r
+" .XXXXXXXXX.    ",\r
+" .XXXXXXXXX.    ",\r
+" .XXXX..........",\r
+" .XXX.ooooooooo.",\r
+" .XX.ooooooooo. ",\r
+" .X.ooooooooo.  ",\r
+" ..ooooooooo.   ",\r
+" ...........    ",\r
+"                ",\r
+"                "};\r
diff --git a/samples/html/helpview/bitmaps/helpoptions.xpm b/samples/html/helpview/bitmaps/helpoptions.xpm
new file mode 100644 (file)
index 0000000..df7f054
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */
+static char * helpoptions_xpm[] = {
+"16 16 2 1",
+"      c None",
+".     c #000000",
+"                ",
+"      ..        ",
+"      ...       ",
+"     ....       ",
+"     . ...      ",
+"    .. ...      ",
+"    .   ..      ",
+"   ..   ...     ",
+"   .     ..     ",
+"   .........    ",
+"  ..     ...    ",
+"  .       ...   ",
+" ..       ...   ",
+" ....   ....... ",
+"                ",
+"                "};
diff --git a/samples/html/helpview/bitmaps/helppage.xpm b/samples/html/helpview/bitmaps/helppage.xpm
new file mode 100644 (file)
index 0000000..3524b01
--- /dev/null
@@ -0,0 +1,23 @@
+/* XPM */\r
+static char * helppage_xpm[] = {\r
+"16 16 4 1",\r
+"      c None",\r
+".     c #808080",\r
+"X     c Gray100",\r
+"o     c Black",\r
+"                ",\r
+"  ..........    ",\r
+"  .XXXXXXXX..   ",\r
+"  .XXXXXXXXooo  ",\r
+"  .X......XXXo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  .X........Xo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  .X........Xo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  .X........Xo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  .X........Xo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  .XXXXXXXXXXo  ",\r
+"  oooooooooooo  "};\r
diff --git a/samples/html/helpview/bitmaps/helpsidepanel.xpm b/samples/html/helpview/bitmaps/helpsidepanel.xpm
new file mode 100644 (file)
index 0000000..ffac7c4
--- /dev/null
@@ -0,0 +1,35 @@
+/* XPM */
+static char * helpsidepanel_xpm[] = {
+"16 15 17 1",
+"      c None",
+".     c #000000",
+"+     c #800000",
+"@     c #008000",
+"#     c #808000",
+"$     c #000080",
+"%     c #800080",
+"&     c #008080",
+"*     c #C0C0C0",
+"=     c #808080",
+"-     c #FF0000",
+";     c #00FF00",
+">     c #FFFF00",
+",     c #0000FF",
+"'     c #FF00FF",
+")     c #00FFFF",
+"!     c #FFFFFF",
+"****************",
+"*..............*",
+"*.************.*",
+"*..............*",
+"*.****.!!!!!!!.*",
+"*.****.!====*!.*",
+"*.****.!!!!!!!.*",
+"*.****.!===*!!.*",
+"*.****.!!!!!!!.*",
+"*.****.!====*!.*",
+"*.****.!!!!!!!.*",
+"*.****.!===*!!.*",
+"*.****.!!!!!!!.*",
+"*..............*",
+"****************"};
diff --git a/samples/html/helpview/bitmaps/helpup.xpm b/samples/html/helpview/bitmaps/helpup.xpm
new file mode 100644 (file)
index 0000000..66694d3
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */\r
+static char * helpup_xpm[] = {\r
+"16 15 3 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"                ",\r
+"       ..       ",\r
+"      .XX.      ",\r
+"     .XXXX.     ",\r
+"    .XXXXXX.    ",\r
+"   .XXXXXXXX.   ",\r
+"  ....XXXX....  ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     .XXXX.     ",\r
+"     ......     ",\r
+"                "};\r
diff --git a/samples/html/helpview/bitmaps/helpuplevel.xpm b/samples/html/helpview/bitmaps/helpuplevel.xpm
new file mode 100644 (file)
index 0000000..e6f41a4
--- /dev/null
@@ -0,0 +1,21 @@
+/* XPM */\r
+static char * helpuplevel_xpm[] = {\r
+"16 15 3 1",\r
+"      c None",\r
+".     c Black",\r
+"X     c Gray100",\r
+"                ",\r
+"      ..        ",\r
+"     .XX.       ",\r
+"    .XXXX.      ",\r
+"   .XXXXXX.     ",\r
+"  .XXXXXXXX.    ",\r
+" ....XXXX....   ",\r
+"    .XXXX.      ",\r
+"    .XXXX.....  ",\r
+"    .XXXXXXXX.  ",\r
+"    .XXXXXXXX.  ",\r
+"    .XXXXXXXX.  ",\r
+"    .XXXXXXXX.  ",\r
+"    ..........  ",\r
+"                "};\r
index 27adb78a3ea8b7d26ecf1e39203e023040a9379c..2b2a2758596b0c06fc690ceec9ad8247a53b8289 100644 (file)
 #include "wx/wxhtml.h"
 #include "wx/fs_zip.h"
 #include "wx/log.h"
+#include "wx/artprov.h"
+#include "wx/filedlg.h"
+
+// Set to 1 to:
+//
+// - provide different icons.
+// - add an open file icon for the toolbar.
+// - use a flat toolbar style.
+// - show a file selector if no file was given on the command line.
+// - remove 'Help:' from the title bar.
+//
+// Set to 0 to revert to previous behaviour.
+
+#define USE_ALTERNATE_UI 0
+
+#if USE_ALTERNATE_UI
+class AlternateArtProvider : public wxArtProvider
+{
+protected:
+    virtual wxBitmap CreateBitmap(const wxArtID& id, const wxArtClient& client,
+                                  const wxSize& size);
+};
+#endif
 
 // ----------------------------------------------------------------------------
 // private classes
@@ -46,6 +69,9 @@ class MyApp : public wxApp
         virtual bool OnInit();
         virtual int OnExit();
 
+        // Prompt the user for a book to open
+        bool OpenBook(wxHtmlHelpController* controller);
+
     private:
         wxHtmlHelpController *help;
 };
@@ -60,6 +86,10 @@ bool MyApp::OnInit()
     delete wxLog::SetActiveTarget(new wxLogStderr); // So dialog boxes aren't used
 #endif
 
+#if USE_ALTERNATE_UI
+    wxArtProvider::PushProvider(new AlternateArtProvider);
+#endif
+  
     wxInitAllImageHandlers();
     wxFileSystem::AddHandler(new wxZipFSHandler);
 
@@ -67,13 +97,25 @@ bool MyApp::OnInit()
     SetAppName("wxHTMLHelp"); 
     wxConfig::Get(); // create an instance
 
-    help = new wxHtmlHelpController;
+    help = new wxHtmlHelpController(
+#if USE_ALTERNATE_UI
+        wxHF_DEFAULT_STYLE|wxHF_FLAT_TOOLBAR|wxHF_OPEN_FILES
+#endif
+        );
     
+#if USE_ALTERNATE_UI
+    help->SetTitleFormat(wxT("%s"));
+    if (argc < 2) {
+        if (!OpenBook(help))
+            return FALSE;
+    }
+#else
     if (argc < 2) {
         wxLogError(wxT("Usage : helpview <helpfile> [<more helpfiles>]"));
         wxLogError(wxT("  helpfile may be .hhp, .zip or .htb"));
         return FALSE;
     }
+#endif
 
     for (int i = 1; i < argc; i++)
         help -> AddBook(argv[i]);
@@ -96,3 +138,138 @@ int MyApp::OnExit()
     return 0;
 }
 
+bool MyApp::OpenBook(wxHtmlHelpController* controller)
+{
+    wxString s = wxFileSelector(_("Open help file"),
+        wxGetCwd(),
+        wxEmptyString,
+        wxEmptyString,
+        _(
+"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);
+            return TRUE;
+        }
+    }
+    return FALSE;
+}
+
+#if USE_ALTERNATE_UI
+
+/*
+ * Art provider class
+ */
+
+// ---------------------------------------------------------------------
+// helper macros
+// ---------------------------------------------------------------------
+
+// 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
+
+// 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;
+#elif defined(__WXGTK__) || defined(__WXMOTIF__)
+    #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; \
+        }
+#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) \
+    }
+
+// ---------------------------------------------------------------------
+// XPMs with the art
+// ---------------------------------------------------------------------
+
+// XPM hack: make the arrays const
+//#define static static const
+
+#include "bitmaps/helpback.xpm"
+#include "bitmaps/helpbook.xpm"
+#include "bitmaps/helpdown.xpm"
+#include "bitmaps/helpforward.xpm"
+#include "bitmaps/helpoptions.xpm"
+#include "bitmaps/helppage.xpm"
+#include "bitmaps/helpsidepanel.xpm"
+#include "bitmaps/helpup.xpm"
+#include "bitmaps/helpuplevel.xpm"
+#include "bitmaps/helpicon.xpm"
+#include "bitmaps/helpopen.xpm"
+
+//#undef static
+
+// ---------------------------------------------------------------------
+// CreateBitmap routine
+// ---------------------------------------------------------------------
+
+wxBitmap AlternateArtProvider::CreateBitmap(const wxArtID& id,
+                                            const wxArtClient& client,
+                                            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_GO_HOME,                             home)
+
+    // Any wxWindows icons not implemented here
+    // will be provided by the default art provider.
+    return wxNullBitmap;
+}
+
+#endif
\ No newline at end of file
diff --git a/samples/html/helpview/helpview.ico b/samples/html/helpview/helpview.ico
new file mode 100644 (file)
index 0000000..cbf2223
Binary files /dev/null and b/samples/html/helpview/helpview.ico differ
index ff5d2239421aad4f7caaa8787af25cc055d84fa3..d43931e59664ddfcc74a39b9b4630edb0d2bc699 100644 (file)
@@ -1,4 +1,5 @@
 /* We need this to get the right default icon. */
-aaaaaa  ICON "mondrian.ico"
+aaaaaa   ICON "helpview.ico"
+helpview ICON "helpview.ico"
 
 #include "wx/msw/wx.rc"