HTML-Hilfe

	// 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)

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

	htmlhelp_links.htm
	htmlhelp_rechts.htm
	htmlhelp_none.htm  

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

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

	#include ..\HTMLHelpDefines.h 

	<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> 

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

• 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 !

  	#include "HTMLHelpDefines.h" 
  
  	/**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, nur das richtige Kapitel wird im Inhaltsverzeichnis aufgerufen. 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;
    	} 

  Das sorgt 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) ) );
  	}   

	// Commands (ID_* and IDM_*) 
	#define HID_EDIT_MENUEPUNKT                     0x18004 

	[FILES]
	...
	hid_edit_menuepunkt.htm 
	...
	[ALIAS]
	...
	HID_EDIT_MENUEPUNKT			= HID_EDIT_MENUEPUNKT.HTM 

	<UL>
	<LI> <OBJECT type="text/sitemap">
		<param name="Name" value="Menüpunkt 'Menüpunkt'">
		<param name="Local" value="hid_edit_menuepunkt.htm">
		</OBJECT>
	</UL>

	// Dialogs (IDD_*) 
	#define HIDD_ABOUTBOX                           0x20064
	#define HIDD_DIALOGHIRNLOS                      0x20067 

	[FILES]
	...
	hidd_dialoghirnlos.htm
	...
	[ALIAS]
	...
	HIDD_DIALOGHIRNLOS			= HIDD_DIALOGHIRNLOS.HTM