From 279e66a1d6f0b80d97d86f8dd378af7216f94bf1 Mon Sep 17 00:00:00 2001
From: Kimmo Varis <kimmov@gmail.com>
Date: Tue, 23 Feb 2010 17:29:49 +0200
Subject: [PATCH] Open HTML help from Help-menu in Windows.

---
 gui/gui.pro        |  2 +-
 gui/main.ui        | 15 ++++++++++++++-
 gui/mainwindow.cpp | 29 +++++++++++++++++++++++++++++
 gui/mainwindow.h   | 11 +++++++++++
 4 files changed, 55 insertions(+), 2 deletions(-)

diff --git a/gui/gui.pro b/gui/gui.pro
index 126767590..62c82abe4 100644
--- a/gui/gui.pro
+++ b/gui/gui.pro
@@ -69,7 +69,7 @@ SOURCES += main.cpp \
 win32 {
 	RC_FILE = cppcheck-gui.rc
 	HEADERS += ../cli/resource.h
-	LIBS += -lshlwapi
+	LIBS += -lshlwapi -lhtmlhelp
 }
 
 # run lrelease before build
diff --git a/gui/main.ui b/gui/main.ui
index 0bed176d0..473f33dca 100644
--- a/gui/main.ui
+++ b/gui/main.ui
@@ -66,7 +66,7 @@
      <x>0</x>
      <y>0</y>
      <width>640</width>
-     <height>22</height>
+     <height>21</height>
     </rect>
    </property>
    <widget class="QMenu" name="mMenuFile">
@@ -101,8 +101,10 @@
     <property name="title">
      <string>&amp;Help</string>
     </property>
+    <addaction name="mActionHelpContents"/>
     <addaction name="mActionLicense"/>
     <addaction name="mActionAuthors"/>
+    <addaction name="separator"/>
     <addaction name="mActionAbout"/>
    </widget>
    <widget class="QMenu" name="mMenuCheck">
@@ -312,6 +314,17 @@
     <string>&amp;Toolbar</string>
    </property>
   </action>
+  <action name="mActionHelpContents">
+   <property name="text">
+    <string>&amp;Contents</string>
+   </property>
+   <property name="statusTip">
+    <string>Open the help contents</string>
+   </property>
+   <property name="shortcut">
+    <string>F1</string>
+   </property>
+  </action>
  </widget>
  <customwidgets>
   <customwidget>
diff --git a/gui/mainwindow.cpp b/gui/mainwindow.cpp
index 94ebe082a..afe25f88b 100644
--- a/gui/mainwindow.cpp
+++ b/gui/mainwindow.cpp
@@ -34,6 +34,12 @@
 #include "report.h"
 #include "../lib/filelister.h"
 
+// HTMLHelp is only available in Windows
+#ifdef WIN32
+#include <windows.h>
+#include <htmlhelp.h>
+#endif
+
 MainWindow::MainWindow() :
         mSettings(new QSettings("Cppcheck", "Cppcheck-GUI", this)),
         mApplications(new ApplicationList(this)),
@@ -74,6 +80,13 @@ MainWindow::MainWindow() :
     connect(mUI.mResults, SIGNAL(GotResults()), this, SLOT(ResultsAdded()));
     connect(mUI.mMenuView, SIGNAL(aboutToShow()), this, SLOT(AboutToShowViewMenu()));
 
+#ifdef WIN32
+    connect(mUI.mActionHelpContents, SIGNAL(triggered()), this, SLOT(OpenHelpContents()));
+#else
+    // Hide if not Windows
+    mUI.mActionHelpContents.setVisible(false);
+#endif
+
     CreateLanguageMenuItems();
     LoadSettings();
 
@@ -640,3 +653,19 @@ void MainWindow::StopChecking()
     mThread->Stop();
     mUI.mResults->DisableProgressbar();
 }
+
+void MainWindow::OpenHelpContents()
+{
+    OpenHtmlHelpContents();
+}
+
+void MainWindow::OpenHtmlHelpContents()
+{
+#ifdef WIN32
+    QString file("/cppcheck.chm");
+    QString exeFolder = QDir::currentPath();
+    exeFolder += file;
+    exeFolder = QDir::toNativeSeparators(exeFolder);
+    HtmlHelp(NULL, exeFolder.utf16(), HH_DISPLAY_TOPIC, NULL);
+#endif // WIN32
+}
diff --git a/gui/mainwindow.h b/gui/mainwindow.h
index 9cb9089c2..485a80410 100644
--- a/gui/mainwindow.h
+++ b/gui/mainwindow.h
@@ -179,6 +179,12 @@ protected slots:
     */
     void StopChecking();
 
+    /**
+    * @brief Open help file contents
+    *
+    */
+    void OpenHelpContents();
+
 protected:
 
     /**
@@ -268,6 +274,11 @@ protected:
     */
     void FormatAndSetTitle(const QString &text = QString());
 
+    /**
+    * @brief Show help contents
+    */
+    void OpenHtmlHelpContents();
+
     /**
     * @brief Program settings
     *