| Autor |
Beitrag |
jaenicke
      
Beiträge: 19346
Erhaltene Danke: 1754
W11 x64 (Chrome, Edge)
Delphi 12 Pro, C# (VS 2022), JS/HTML, Java (NB), PHP, Lazarus
|
Verfasst: Mo 05.07.04 14:50
Hallo!
Ich habe jetzt eine HTML-Hilfe erstellt, das geht auch ganz gut.
Jetzt möchte ich aber (wie z.B. bei M$ Office) Links in der Hilfe anbieten, auf die man klicken kann, um im Programm etwas auszulösen, beispielsweise eine Vorführung einer Funktion.
Eine Möglichkeit wäre wohl die Programmdatei mit Parametern aufzurufen und diese so zu konfigurieren, dass bei Parametern statt einer neuen Instanz die Parameter an die alte geleitet werden.
Das wär zwar programmiertechnisch einfach, aber nicht sonderlich elegant...
Gibts da vielleicht eine bessere Möglichkeit, d.h. evtl. sogar eine, die auch so für diese HTML-Hilfe vorgesehen war?
Danke schon mal,
Sebastian
|
|
MathiasSimmack
Ehemaliges Mitglied
Erhaltene Danke: 1
|
Verfasst: Mo 05.07.04 18:48
Ich gebe zu, dass ich mir diesen Teil des Help-API noch nie angesehen habe, aber ich möchte behaupten, dass es entsprechende Kommandos gibt. Das gab es ja bereits bei den HLP-Dateien. Du wirst leider nicht drum herum kommen, mal einen Blick in die Hilfe von Microsoft zu schauen, die du bspw. hast wenn du den HTML Helpworkshop installiert hast.
PS: Da ich aber selbst Interesse an solchen Dingen habe, werde ich´s mir wohl auch mal anschauen. 
|
|
MathiasSimmack
Ehemaliges Mitglied
Erhaltene Danke: 1
|
Verfasst: Mo 05.07.04 19:36
So, die Lösung heißt WM_TCARD. Diese Message kannst du mit einem ActiveX-Control von der Hilfedatei an dein Programm senden lassen. Ich weiß nicht, wie du die Hilfedatei erstellst, aber relativ einfach geht´s mit dem HTML Helpworkshop von Microsoft. Aber auch andere Programme dürften etwas vergleichbares haben. Allerdings gibt´s im Helpworkshop wohl einen kleinen Bug.
Wenn du mit dem Assistenten für ActiveX-Controls (der blaue Zauberhut in der Toolbar) eine "Training Card" einfügen lässt, dann wird der lParam-Wert fälschlich als "Item2" eingetragen. Das ist bspw. der Code, den der Assistent für einen Button erzeugt:
Quelltext 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11:
| <OBJECT id=hhctrl type="application/x-oleobject" classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11" codebase="hhctrl.ocx#Version=5,2,3735,0" width=100 height=100 > <PARAM name="Command" value="TCard"> <PARAM name="Button" value="Text:TCard-Test"> <PARAM name="Item1" value="666"> <PARAM name="Item2" value="Hallo Welt!"> </OBJECT> |
Richtig wäre aber
Quelltext 1:
| <PARAM name="Item1" value="666, Hallo Welt!"> |
Die 666 wäre der wParam, "Hallo Welt!" wie gesagt der lParam. Du kannst es auch als unsichtbares Control machen und mit einem JavaScript-Link ansprechen. Der Assistent bietet eine entsprechende Funktionalität an. Du müsstest dann einen Link wie
Quelltext 1:
| <a href="javascript:hhcrl.Click()">klick</a> |
einfügen.
Aber egal. Wenn du diese Training Card nun benutzt, dann sendet die Hilfedatei die beiden o.g. Werte an dein Programm, die du bspw. wie folgt empfangen kannst:
Delphi-Quelltext 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15:
| type TForm1 = class(TForm) private procedure WmTCard(var Msg: TMessage); message WM_TCARD; end;
procedure TForm1.WmTCard(var Msg: TMessage); var p : pchar; begin p := pchar(Msg.LParam); if(Msg.WParam = 666) then ShowMessage(p); end; |
Voraussetzung ist allerdings, dass die HTML-Hilfe über dein Programm gestartet wird, und zwar über das HTML-Help-API. Ich benutze dazu bspw. die JEDI-Unit
Delphi-Quelltext 1: 2: 3: 4: 5: 6: 7: 8:
| procedure TForm1.Button1Click(Sender: TObject); var Url : string; begin Url := ExtractFilePath(paramstr(0)) + 'sample.chm::/page2.htm'; if(HtmlHelpIsAvail) then HtmlHelp(self.Handle,pchar(Url),HH_DISPLAY_TOPIC,0); end; |
Der Vorteil wäre, dass dein Programm dann entsprechend reagieren kann. Du musst ja keine Strings senden. Der lParam kann ja auch ein bestimmter numerischer Wert sein, der eine bestimmte Funktion in deinem Programm auslöst. Als Reaktion darauf ruft dein Programm mit dem HTML-Help-API vielleicht die nächste Seite in der Hilfedatei auf, usw.
An sich eine lustige Spielerei.
Ich hoffe, das hilft dir ein bisschen.
|
|
jaenicke 
      
Beiträge: 19346
Erhaltene Danke: 1754
W11 x64 (Chrome, Edge)
Delphi 12 Pro, C# (VS 2022), JS/HTML, Java (NB), PHP, Lazarus
|
Verfasst: Di 06.07.04 13:46
Danke, und übrigens: Ich hab in die API-Hilfe schon mehr als einen Blick getan gehabt, DAS allerdings bisher nicht gefunden gehabt...
Also danke, und auch dir noch viel Spaß damit, wenn du auch was damit machst...
Sebastian
PS: Und bei der Beitragszahl (ist gerade 313) heiß ich jetzt wohl Donald Duck...
|
|
MathiasSimmack
Ehemaliges Mitglied
Erhaltene Danke: 1
|
Verfasst: Di 06.07.04 14:34
| jaenicke hat folgendes geschrieben: | | Danke, und übrigens: Ich hab in die API-Hilfe schon mehr als einen Blick getan gehabt, [...] |
Das konnte ich nicht wissen. Viele Leute starten die Hilfedatei ja einfach nur mit "ShellExecute". Ich wusste nicht ob du auch zu diesen ... Banausen gehörst
| Zitat: | | Also danke, und auch dir noch viel Spaß damit, wenn du auch was damit machst... |
Ich überlege gerade, ob ich das entsprechende Kapitel in den Win32-API-Tutorials ergänzen sollte. Aber da müsste ich mir ein sinnvolles Anwendungsbeispiel einfallen lassen. Na, mal seh´n ... wenn mich die Langeweile packt, ...
btw: Du könntest ggf. deine Frage als erledigt kennzeichnen.
|
|
jaenicke 
      
Beiträge: 19346
Erhaltene Danke: 1754
W11 x64 (Chrome, Edge)
Delphi 12 Pro, C# (VS 2022), JS/HTML, Java (NB), PHP, Lazarus
|
Verfasst: Mi 07.07.04 08:40
"Sinnvolles" Beispiel:
Wie waers mit nem simplen Form, auf der zum Beispiel die Summe zweier Zahlen berechnet wird oder so.
Und in der Hilfe-Datei werden die erklaert, und mit nem Klick auf einen Link veraendert sich die Hintergrundfarbe der Edits ein paarmal, so dass sie zwei Sekunden blinken.
Das ist zwar kein sonderlich sinnvolles Beispiel, aber es wuerde immerhin die Funktionsweise deutlich machen...
Uebrigens funktioniert das bei mir jetzt so, dass man bei einem Klick auf einen entsprechenden Link in der Hilfe einen zweiten Mauszeiger sieht (eine Bitmap...), der langsam zu der richtigen Stelle wandert und dort klickt usw.
Also nochmal danke, darauf waer ich allein nicht so schnell gekommen...
|
|
|