Autor Beitrag
Logikmensch
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 390

Win XP
Delphi 2007 Prof., XE2, XE5
BeitragVerfasst: Do 06.04.06 05:30 
Hallo,

ich sitze schon ein paar Tage an einem Problem, seit ich beschlossen habe, statt meiner bisher verwendeten HLP-Hilfedateien auf das optisch schönere HTML-Help (*.CHM) umzusatteln.
Ich verwende Help&Manual, mit welchem man sowohl HLP- als auch CHM-Dateien erzeugen kann. Meine Kontext-Hilfeziele sind alle mit Help-IDs (Integerwerten) gesetzt.

Bisher, also bei WinHelp, arbeite ich mit folgender Ereignisprozedur von meinem TForm-Object, um auf Kontext-Hilfeanfragen des Benutzers zu reagieren. Das funktioniert auch prima:

ausblenden Delphi-Quelltext
1:
2:
3:
4:
function TForm1.FormHelp(Command: Word; Data: Integer; var CallHelp: Boolean): Boolean;
begin
  result:=WinHelp(self.Handle,pchar(application.HelpFile),command,data);
end;


In Application.HelpFile habe ich im FormCreate-Ereignis den Pfad zu der Hilfedatei (*.HLP / *.CNT) gesetzt. Nun hoffte ich, das ganze auch mit CHM-Dateien und dem Aufruf von HTMLHELP statt WINHELP zu schaffen, zumal ja auch die Syntax recht ähnlich schien:

ausblenden Delphi-Quelltext
1:
2:
3:
4:
function TForm1.FormHelp(Command: Word; Data: Integer; var CallHelp: Boolean): Boolean;
begin
  result:=HTMLHelp(self.Handle,pchar(application.HelpFile),command,data)<>0;
end;


Es wird zwar die Hilfedatei angezeigt, allerdings wird trotz korrekt übergebener Help-ID nicht die entsprechende Kontexthilfe angezeigt - die Hilfedatei befindet sich stets in der Standardhilfe.

Natürlich habe ich meine Hausaufgaben gemacht (z.B. hier im Forum gesucht, bei MS nachgelesen etc.), aber kann es mir nicht erklären. Dann habe ich es auch mal mit dem Parameter HH_DISPLAY_TOPIC versucht, statt dem Wert von Command - dann aber wird gar keine Hilfedatei geöffnet. Jedenfalls schreibt Microsoft, dass der Parameter DATA den Pointer (darunter verstehe ich meine HELP-ID) zu dem Hilfetext haben muss. Das ist der Fall.

Weiß jemand rat? Es kann doch nicht sooo schwer sein, von WinHelp auf HTMLHelp umzusatteln, oder? ;-)

Liebe Grüße,

Claus.
Logikmensch Threadstarter
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 390

Win XP
Delphi 2007 Prof., XE2, XE5
BeitragVerfasst: Fr 07.04.06 05:06 
Tja, so ist das. Da habe ich doch glatt doch noch selbst die Antwort auf meine Frage gefunden. Damit dieser Thread wenigstens nicht ganz umsonst war, schreibe ich die Problemlösung gleich mit hier rein - vielleicht kann's ja jemand gebrauchen. :-)

Um wahlweise HLP und CHM-Dateien über die Ereignisprozedur FormHelp aufzurufen, kann man folgenden Aufruf verwenden. Voraussetzung ist hier, dass im FormCreate-Ereignis der absolute Pfad der Hilfedatei in das Property Application.HelpFile übergeben wird.

ausblenden Delphi-Quelltext
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
function TForm1.FormHelp(Command: Word; Data: Integer; var CallHelp: Boolean): Boolean;  
var
  ext:string;
begin  
  ext:=uppercase(extractfileext(Application.HelpFile));
  if ext='.HLP' then result:=WinHelp(self.Handle,pchar(application.HelpFile),command,data)
    else
  if ext='.CHM' then result:=HTMLHelp(self.Handle,pchar(application.HelpFile),HH_HELP_CONTEXT,data)<>0
    else result:=false;
end;


Das ist sowohl für das Drücken der F1-Taste, wie auch für ein über einen Help-Button ausgelöstes Hilfesystem verwendbar. Wer weitere Hilfe dazu braucht, ich gebe gerne weitere Tipps. Ist ja wohl doch kein so ganz triviales Thema.

Grüße an alle!