HTML-Hilfe

Ziel dieses Beispiels:
Ein HTML-basierendes Hilfesystem soll verwendet werden.
Hier gibt es das Beispiel zum Download: HTMLHelp.zip
Referenz-Links:
Knowledge Base Artikel 191118 How To Create Context-Sensitive HTML Help in an MFC Application
Technical Note TN028 Context-Sensitive Help Support

Schritt 1: Anwendungsgerüst

Erstellen des Anwendungsgerüsts (SDI-Anwendung) wie in den bisherige Beispielen.
In den "Advanced Features" wird die Checkbox "Context-sensitive Help" mit der Option "HTML Help Format" gesetzt.
HTML-Hilfe aktivieren

Beim Compilieren des Projekts wird der Help Compiler aufgerufen. Wird das Projekt gestartet gelangt man durch Drücken von "F1" oder über das Menü "Hilfe" in ein Hilfe-Template, das schon Einträge für die generierten Menüpunkte enthält.
Neu ist ein Unterverzeichnis "hlp" im Projekt, dass die HTML-Dateien der Hilfe enthält.
Verzeichnisstruktor

Aus diesen erzeugt der HTML Help Compiler (hhc.exe, im Verzeichnis "C:\Programme\HTML Help Workshop"), der beim compilieren kurz als Dos-Fenster auftaucht, eine chm-Datei, die ins Debug/Release-Verzeichnis kopiert wird.

Im Code findet sich nur eine einzige Änderung:
In MainFrm.cpp gibt es vier neue Einträge in der Message Map, die die Hilfe-Befehle auf Standard-Methoden von CFrameWnd (bzw. CWnd, dort sind sie deklariert) umleiten.


	// Globale Hilfebefehle
	ON_COMMAND(ID_HELP_FINDER, CFrameWnd::OnHelpFinder)
	ON_COMMAND(ID_HELP, CFrameWnd::OnHelp)
	ON_COMMAND(ID_CONTEXT_HELP, CFrameWnd::OnContextHelp)
	ON_COMMAND(ID_DEFAULT_HELP, CFrameWnd::OnHelpFinder)

Das Drücken von "F1" wird durch die Methode "OnHelp" abgehandelt.

Schritt 2: Programmlogik

Das Fenster der CView soll zwei Rechtecke enthalten. Wenn der User in eines davon klickt (sozusagen ein Auswählen) und dann F1 drückt soll er eine Contextabhängige Hilfe bekommen. Dazu im OnDraw zwei Rechteckt der Größe 200x200 zeichnen, das aktuell gewählte bekommt ein Fokus-Rechteck.
So soll es aussehen

Das Event "OnLButtonDown" speichert die Mausklick-Position in einer Instanzvariablen (im Konstruktor mit "-1/-1" initialisiert) und löst ein Repaint aus.

Schritt 3: Neue Hilfeeinträge

Jeder Hilfseintrag steht in einer eigenen HTML-Datei. Normalerweise enthalten diese den Namen des Controls/Menüpunkts, für den sie gelten. Da wir hier aber eigene Hilfe-Themen gebaut haben, verwenden wir einen leicht anderen Ansatz.
Zuerst einmal bauen wir drei HTML-Dateien "htmlhelp_links.htm", "htmlhelp_rechts.htm" und "htmlhelp_none.htm" im Verzeichnis "hlp". Ich habe hierzu die Datei "scrollbars.htm" kopiert und umbenannt. Der Inhalt ist reines HTML, zu beachten ist nur dass der Anchor mit dem Namen der Hilfe-Datei vorhanden ist (im Beispiel: htmlhelp_links.htm):

	<A NAME="htmlhelp_links"></A>

Wichtig: Diese Dateien dem Projekt zufügen: im "Solution Explorer" die "HTML Help Topics" auswählen, Rechtsklick und "Add Existing Item..." wählen.

In der Datei "./help/HTMLHelp.hhp" erfolgt die Definition der Hilfe.
In der Sektion "[FILES]" fügen wir drei neue Einträge ein:

	htmlhelp_links.htm
	htmlhelp_rechts.htm
	htmlhelp_none.htm

In der Sektion "[ALIAS]" (Mapping von internen Alias-Namen auf Dateien) erfolgen ebenfalls drei Einträge:

	HTMLHELP_RECHTECK_LINKS				= HTMLHELP_LINKS.HTM
	HTMLHELP_RECHTECK_RECHTS			= HTMLHELP_RECHTS.HTM 
	HTMLHELP_RECHTECK_NONE				= HTMLHELP_NONE.HTM

Schließlich werden in der Sektion "[MAPS]" die drei Alias-Namen aus der vorherigen Sektion definiert:

	#define HTMLHELP_RECHTECK_LINKS			0x1
	#define HTMLHELP_RECHTECK_RECHTS		0x2
	#define HTMLHELP_RECHTECK_NONE			0x3

Gemäß Technical Note 28 ist der Bereich von 0x00000000 bis 0x0000FFFF "user defined", darf also für sonstige Hilfe-IDs verwendet werden.
Achtung: NICHT mit "0x0" beginnen, da die Help-ID bei der Message "WM_HELPHITTEST" als Rückgabe dient und "0x0" dann "nicht gefunden" bedeuten würde !
Hinweis: In der "[MAPS]"-Sektion wird zuerst "HTMLDefines.h" includiert. Dort können wir unsere Defines jedoch nicht unterbringen da die Datei bei jedem compilieren neu (aus der Resourcen-Datei ?) erzeugt wird.

Im Beispielprogramm ist dies ein wenig cleverer gelöst, indem die Defines in eine eigene Headerdatei "HTMLHelpDefines.d" verschoben sind.
In der "[MAPS]"-Sektion von "HTMLHelp.hhp" wird nur diese Datei eingebunden (die in diesem Fall nicht im gleichen Verzeichnis wie die hhp-Datei liegt !):

#include ..\HTMLHelpDefines.h

Letzter Schritt: die Dateien in den Hilfe-Inhalt-Baum eintragen. Dazu die Datei "HTMLHelp.hcc" öffnen und folgendes einfügen:

	<LI> <OBJECT type="text/sitemap">
		<param name="Name" value="Rechteck: links">
		<param name="Local" value="htmlhelp_links.htm">
		</OBJECT>
	<LI> <OBJECT type="text/sitemap">
		<param name="Name" value="Rechteck: rechts">
		<param name="Local" value="htmlhelp_rechts.htm">
		</OBJECT>
	<LI> <OBJECT type="text/sitemap">
		<param name="Name" value="Rechteck: none">
		<param name="Local" value="htmlhelp_none.htm">
		</OBJECT>

Das Ergebnis sieht so aus:
Hilfe-Inhalt

Jetzt können wir das Programm starten und sehen unsere Hilfedateien in der Hilfe selbst, kommen aber mit F1 noch nicht dorthin.

Einträge in Karteikarte "Index" einfügen:
Hierzu einfach folgenden Eintrag in den Body einer HTML-Datei einfügen:

	<OBJECT TYPE="application/x-oleobject" CLASSID="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
		<PARAM NAME="Keyword" VALUE="Rechteckfenster">
	</OBJECT>

Wichtig ist das "Value"-Attribut des Elements "param".
Im Beispiel habe ich für alle drei Rechteckfenster-Hilfedateien diesen Eintrag eingefügt. Das führt zu diesem Ergebnis:
Hilfeindex

Schritt 4: Von der View zur Hilfe

Hier können wir keine Standard-MFC-Verknüpfung der Hilfeeinträge verwenden, da diese nur pro Menüpunkt oder Control angebbar ist, aber nicht dynamisch. Also tricksen wir in der View ein wenig:

Zuerst einmal definieren wir uns eine Methode die aus einem Punkt der View die ID des Hilfe-Topics ermittelt.
Da wir unsere eigenen Hilfe-IDs in die Datei "HTMLHelpDefines.h" verlegt haben können wir diese includieren und deren Konstanten verwenden !

	//Ermitteln der aktuell gültigen Hilfe (je nach Context !)
	//@param pointClicked Ein Punkt auf der view für den die Hilfe gesucht wird.
	//@return Hilfe-ID für "Rechteck links", "Rechteck rechts" oder "Kein Rechtecke",
	//je nachdem wohin geklickt wurde.
	int CHTMLHelpView::GetHelpID (CPoint pointClicked)
	{
		//Die beiden Rechtecke:
		CRect rectLinks (0, 0, 200, 200);
		CRect rectRechts (200, 0, 400, 200);

		//In welchem Rechteck steckt der Punkt ?
		if (rectLinks.PtInRect (pointClicked) == TRUE)
			return HTMLHELP_RECHTECK_LINKS
		else if (rectRechts.PtInRect (pointClicked) == TRUE)
			return HTMLHELP_RECHTECK_RECHTS
		else
			return HTMLHELP_RECHTECK_NONE
	}

Beim F1-Drücken soll je nach gewählten Rechteck eine kontextbezogene Hilfe angezeigt werden. Es klingt logisch in der View-Klasse die Methode "OnHelp" zu überladen. Leider klappt das nicht so ganz, da "Wnd::OnHelp" eine ganze Reihe mehr macht. Z.B. wird zuerst geprüft ob gerade ein Menüpunkt gewählt ist. Wenn ja dann wird dessen Hilfe angezeigt (falls definiert). Am Ende zeigt "OnHelp" auf jeden Fall die Startseite der Hilfe an. Ein Aufruf der Basisklassenmethode hilft ebenfalls nicht weiter da nicht erkennbar ist ob in der Basisklasse ein Hilfethema gefunden wurde oder ob wir unsere Logik greifen lassen können.
Mit ein wenig Debuggen durch MFC-Klassen findet man aber folgendes heraus:
- CWnd::OnHelp sendet eine Message "WM_COMMANDHELP" an das aktive Fenster und anschließend an dessen Besitzer. Dies geschieht solange bis ein Fenster angibt dass es die Nachricht behandelt hat. Also in die MessageMap unserer View-Klasse diesen Eintrag einfügen (die Konstante WM_COMMANDHELP ist in "afxpriv.h" deklariert):
```
	ON_MESSAGE (WM_COMMANDHELP, OnCommandHelp)  
```
  Die Implementierung der Methode sieht so aus:
```
	LRESULT CHTMLHelpView::OnCommandHelp(WPARAM, LPARAM lParam)
	{
		DWORD dwContextID = this->GetHelpID (this->pointClick);
		AfxGetApp ()->HtmlHelp (dwContextID, HH_HELP_CONTEXT);
		return TRUE;
	}	  
```
  Die HelpID des aktuell gewählten Rechtecks im Fenster wird geholt und die Hilfe wird angezeigt.
- Das alleine hilft uns allerdings nicht, da irgendwo in der MFC trotzdem die Startseite der Hilfe angezeigt wird. Liegt scheinbar an Wnd::OnHelpInfo, die am Ende die Default-Window-Prozedur aufruft und dabei wird intern wiederum OnHelp aufgerufen (WM_HELPINFO scheint im Kern eine WM_HELP-Message mit anderem Parameter zu sein).
  Also die "WM_HELPINFO"-Message verarbeiten.
  
  Der Code sieht so aus:
```
	BOOL CHTMLHelpView::OnHelpInfo(HELPINFO* pHelpInfo)
	{
		//Geklicktes Rechteck ermitteln:
		pHelpInfo->dwContextId = this->GetHelpID ( CPoint (pHelpInfo->MousePos.x, pHelpInfo->MousePos.y) );

		return TRUE;
	} 
```
Beide Meldungen zusammen sorgen dafür dass wir im Clientbereich der View herumklicken können und durch F1 das Hilfefenster zum gewählten Rechteck gerufen wird. Haben wir einen Hauptmenüpunkt aufgeklappt führt uns F1 zu dessen Hilfe.
Jetzt gibt es noch den Button "Kontextbezogene Hilfe" in der Toolbar, der es erlaubt, Hilfe zu einem bestimmten Control abzurufen. Die MFC sendet bei Auswahl eines Controls die Message WM_HELPHITTEST an das aktive Fenster. Wenn die Nachricht eine Help-ID zurückliefert wird die Hilfe hierzu angezeigt.
In die MessageMap der view wird folgender Eintrag zugefügt:
```
	ON_MESSAGE (WM_HELPHITTEST, OnHelpHitTest) 
```
Wichtig: WM_HELPHITTEST ist in der Header-Datei "afxpriv.h" deklariert.

Die Implementierung von OnHelpHitTest sieht so aus:
```
	//Message WM_HELPHITTEST verarbeiten: Help-ID zum Punkt holen.
	//@param wParam uninteressant
	//@param lParam Enthält im LoWord die x-Koordinate, im HighWord die y-Koordinate
	//des geklickten Punkts.
	//@return Eine der drei Help-Ids des Fensters.
	LRESULT CHTMLHelpView::OnHelpHitTest(WPARAM wParam, LPARAM lParam)
	{
		return this->GetHelpID( CPoint ( LOWORD(lParam), HIWORD (lParam) ) );
	}

  
```

Weiteres

Den Hilfe-Dateien können wir Bilder zufügen. Diese werden im Unterverzeichnis ".\hlp\Images" abgelegt und beim Erstellen der Hilfe in die chm-Datei eingebunden, sofern aus einer HTML-Datei darauf verwiesen wird. Im Beispiel: die Hilfethemen für "Linkes/rechtes Rechteck gewählt" haben jeweils einen Screenshot eingebunden.
Im Projekt (Solution Explorer) werden diese Dateien unter "Resource Files" eingebunden.
Der Standard-Weg: Hilfe für einen Menüpunkt ohne Tricks und Co: Das Beispiel hat bisher einen Riesen-Aufwand gezeigt um Mausposition-bezogene Hilfe einzubauen. Für Menüpunkte, Controls und Fenster gibt es aber auch ganz normale Standard-Hilfe, die man ohne Aufwand erreicht. Das Beispiel enthält im Menü "Bearbeiten" einen Menüpunkt "ID_EDIT_MENUEPUNKT" (der einen Dialog aufruft). Beim Compilieren wird in ".\hlp\HTMLDefines.h" ein neuer Hilfe-Alias angelegt:
```
	// Commands (ID_* and IDM_*) 
	#define HID_EDIT_MENUEPUNKT                     0x18004 
```
Die ID des Menüpunkts ergibt durch Voranstellen von "H" den Hilfe-Alias. Jetzt legen wir die HTML-Datei dazu an und benennen sie genauso wie den Alias (hid_edit_menuepunkt.htm). Ich habe im Beispiel die Datei aus "hid_edit_cut.htm" dupliziert.
In "HTMLHelp.hhp" müssen wir die Datei wie gehabt unter "[FILES]" eintragen, außerdem einen Eintrag in die Alias-Verknüpfungen vornehmen.
```
	HID_EDIT_MENUEPUNKT			= HID_EDIT_MENUEPUNKT.HTM 
```
Wir könnten den Eintrag als neuen Unterknoten im Inhalt beim Menü "Bearbeiten" einfügen. Dazu in "HTMLHelp.hhc" folgendes nach dem Knoten "Befehle im Menü 'Bearbeiten'" einfügen:
```
	<UL>
	<LI> <OBJECT type="text/sitemap">
		<param name="Name" value="Menüpunkt 'Menüpunkt'">
		<param name="Local" value="hid_edit_menuepunkt.htm">
		</OBJECT>
	</UL>
```
Und nochmal der Standard-Weg: Hilfe für einen Dialog.
Dem Beispiel einen Dialog "DialogHirnlos" zufügen und diesen anzeigen wenn der Menüpunkt aus dem letzten Schritt gewählt wird. In ".\hlp\HTMLDefines.h" wird ein neuer Eintrag mit einer Hilfe-ID angelegt:
```
	// Dialogs (IDD_*) 
	#define HIDD_ABOUTBOX                           0x20064
	#define HIDD_DIALOGHIRNLOS                      0x20067 
```
Auch hier eine HTML-Datei für die Dialog-Hilfe anlegen ("hidd_dialoghirnlos.htm") und in "HTMLHelp.hhp" unter "[FILES]" und "[ALIAS]" Einträge vornehmen.

HTML-Hilfe in ein bestehendes Projekt einbauen

Ideales Vorgehen: ein SDI-Projekt "NoHelp" ohne Hilfe und ein Projekt "WithHelp" mit HTML-Hilfe erstellen. Diese beiden Projekte vergleichen und die Änderungen nachbauen.

Das Zielprojekt darf nicht mit Visual Studio offen sein während wir dies hier machen
Den Inhalt des Ordners "hlp" mit Ausnahme von "HTMLDefines.h" (wird bei jedem Build erzeugt) in das Zielprojekt kopieren.
Die hhc, hhp und hhk-Dateien im "hlp"-Unterverzeichnis umbenennen: müssen den Namen der neuen Anwendung haben.

Die Datei "xxx.vcproj" der beiden Projekte öffnen und folgendes aus dem Help-Projekt ins hilflose Projekt übertragen:
(ROT markierte Abschnitte müssen durch den Namen des Zielprogramms ersetzt werden !)
In der Sektion "<Filter Name="Header Files"..." wird dieses Stück gesucht:

	<File
		RelativePath=".\Resource.h">
	</File>

Ersetzen durch dieses (im Prinzip eine Batch-Datei, die als XML-Attribut deklariert ist ;-). ">", "<" und "&" sind hier XML-Entities und stehen so auch in der vcproj-Datei ! Nur im HTML-Quelltext dieser Seite tauchen noch weitere auf ! ):

	<File RelativePath=".\Resource.h">
		<FileConfiguration Name="Debug|Win32">
			<Tool
				Name="VCCustomBuildTool"
				Description="Generating map file for help compiler..."
				CommandLine="echo // Generated Help Map file.  Used by YourApp.HHP. &gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt; &quot;hlp\HTMLDefines.h&quot;
echo // Commands (ID_* and IDM_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h ID_,HID_,0x10000 IDM_,HIDM_,0x10000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Prompts (IDP_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDP_,HIDP_,0x30000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Resources (IDR_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDR_,HIDR_,0x20000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Dialogs (IDD_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDD_,HIDD_,0x20000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Frame Controls (IDW_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h /a afxhh.h IDW_,HIDW_,0x50000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
"
				Outputs="hlp\HTMLDefines.h"/>
		</FileConfiguration>
		<FileConfiguration
			Name="Release|Win32">
			<Tool
				Name="VCCustomBuildTool"
				Description="Generating map file for help compiler..."
				CommandLine="echo // Generated Help Map file.  Used by YourApp.HHP. &gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt; &quot;hlp\HTMLDefines.h&quot;
echo // Commands (ID_* and IDM_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h ID_,HID_,0x10000 IDM_,HIDM_,0x10000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Prompts (IDP_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDP_,HIDP_,0x30000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Resources (IDR_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDR_,HIDR_,0x20000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Dialogs (IDD_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h IDD_,HIDD_,0x20000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo. &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
echo // Frame Controls (IDW_*) &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
makehm /h /a afxhh.h IDW_,HIDW_,0x50000 &quot;$(InputFileName)&quot; &gt;&gt; &quot;hlp\HTMLDefines.h&quot;
"
				Outputs="hlp\HTMLDefines.h"/>
		</FileConfiguration>
	</File>

In der Sektion "<Filter Name="Resource Files"..." wird folgendes eingefügt:

	<File
		RelativePath=".\hlp\Images\Bullet.gif">
	</File>

Die beiden Filter-Sektionen "HTML Help Files" und "HTML Help Topics" einfügen.

	<Filter
		Name="HTML Help Files"
		Filter="hhp;hhc;hhk;gif;jpg">
		<File
			RelativePath=".\hlp\YourApp.hhc">
		</File>
		<File
			RelativePath=".\hlp\YourApp.hhk">
		</File>
		<File
			RelativePath=".\hlp\YourApp.hhp">
			<FileConfiguration
				Name="Debug|Win32">
				<Tool
					Name="VCCustomBuildTool"
					Description="Making help file..."
					CommandLine="start /wait hhc &quot;hlp\YourApp.hhp&quot;
if not exist &quot;hlp\YourApp.chm&quot; goto :HelpError
copy &quot;hlp\YourApp.chm&quot; &quot;$(OutDir)\YourApp.chm&quot;
goto :HelpDone
:HelpError
echo hlp\YourApp.hhp(1) : error:Problem encountered creating help file
echo.
:HelpDone
echo.
"
					AdditionalDependencies="hlp\HTMLDefines.h"
					Outputs="$(OutDir)\$(ProjectName).chm"/>
			</FileConfiguration>
			<FileConfiguration
				Name="Release|Win32">
				<Tool
					Name="VCCustomBuildTool"
					Description="Making help file..."
					CommandLine="start /wait hhc &quot;hlp\YourApp.hhp&quot;
if not exist &quot;hlp\YourApp.chm&quot; goto :HelpError
copy &quot;hlp\YourApp.chm&quot; &quot;$(OutDir)\YourApp.chm&quot;
goto :HelpDone
:HelpError
echo hlp\YourApp.hhp(1) : error:Problem encountered creating help file
echo.
:HelpDone
echo.
"
					AdditionalDependencies="hlp\HTMLDefines.h"
					Outputs="$(OutDir)\$(ProjectName).chm"/>
			</FileConfiguration>
		</File>
	</Filter>
	<Filter
		Name="HTML Help Topics"
		Filter="htm;html">
		<File
			RelativePath=".\hlp\afx_hidd_color.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_fileopen.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_filesave.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_find.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_font.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_newtypedlg.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_print.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_printdlg.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_printsetup.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidd_replace.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidp_default.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidw_dockbar_top.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidw_preview_bar.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidw_status_bar.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\afx_hidw_toolbar.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_app_about.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_app_exit.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_context_help.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_clear.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_clear_all.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_copy.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_cut.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_find.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_paste.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_redo.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_repeat.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_replace.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_edit_undo.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_close.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_mru_file1.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_new.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_open.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_page_setup.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_print.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_print_preview.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_print_setup.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_save.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_save_as.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_file_send_mail.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_help_index.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_help_using.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_ht_caption.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_ht_nowhere.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_next_pane.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_prev_pane.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_close.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_maximize.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_minimize.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_move.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_nextwindow.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_prevwindow.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_restore.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_size.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_sc_tasklist.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_view_ruler.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_view_status_bar.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_view_toolbar.htm"
			DeploymentContent="TRUE">
			</File>
		<File
			RelativePath=".\hlp\hid_window_all.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_arrange.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_cascade.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_new.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_split.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_tile.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_tile_horz.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hid_window_tile_vert.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\hidr_doc1type.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\main_index.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\menu_edit.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\menu_file.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\menu_help.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\menu_view.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\menu_window.htm"
			DeploymentContent="TRUE">
		</File>
		<File
			RelativePath=".\hlp\scrollbars.htm"
			DeploymentContent="TRUE">
		</File>
	</Filter>

Die hhp-Datei öffnen in der ersten Sektion, "[OPTIONS]" die Einträge für "Compiled file", "Contents file" und "Index file" anpassen:
```
	Compiled file=YourApp.chm
	Contents file=YourApp.hhc
	Index file=YourApp.hhk  
```

Die MessageMap von CMainFrame um vier Einträge erweitern:

	BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd)
		ON_WM_CREATE()
		// Globale Hilfebefehle
		ON_COMMAND(ID_HELP_FINDER, CFrameWnd::OnHelpFinder)
		ON_COMMAND(ID_HELP, CFrameWnd::OnHelp)
		ON_COMMAND(ID_CONTEXT_HELP, CFrameWnd::OnContextHelp)
		ON_COMMAND(ID_DEFAULT_HELP, CFrameWnd::OnHelpFinder)
	END_MESSAGE_MAP()

Im Konstruktor der von CWinApp abgeleiteten Klasse folgendes eintragen:
```
	EnableHtmlHelp(); 
```
(nicht zwingend) Menü anpassen: Im Menü "Hilfe" einen Punkt "Hilfethemen" sowie einen Separator einbauen.
(nicht zwingend) Toolbar: An die Toolbar einen Button mit der ID "ID_CONTEXT_HELP" und dem Prompt "Zeigt Hilfe zu Schaltflächen, Menüs und Fenstern an.\nHilfe" einfügen. Am besten den Button aus dem Dummy-Hilfeprojekt kopieren.
Wichtig: damit "F1" in der neu erzeugten Anwendung funktioniert muss der entsprechende Shortcut in die "Accelerator" eingetragen werden: Resourcenansicht öffnen, unter "Accelerator" IDR_MAINFRAME öffnen und Einträge für F1 und Shift-F1 zufügen. Bitte beachten dass ID_HELP als ID gewählt wird und nicht IDHELP (die gibt es auch).

Version 1.1.0.1, Stand 17.07.2005
Historie:
1.0.0.0 (26.06.2005) Beispiel zugefügt.
1.1.0.0 (27.06.2005) Wie versehe ich ein hilfloses Projekt mit einer Solchen ?
Beispiel gesäubert: Hilfe-IDs in eigener Headerdatei.
1.1.0.1 (17.07.2005) Die Umstellung eines existierenden Projekts unterstützte F1 nicht.