Add Help to Your Application/de: what changed
Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | =Hilfe für Ihre Anwendungen= Die LCL besitzt ein Hilfesystem und ermöglicht es Ihnen, Ihren eigenen Anwendungen eine Hilfefunktion hinzuzufügen. | |
| 2 | 2 | ||
| 3 | 3 | ## Schnellstart | |
| 4 | 4 | ||
| 5 | 5 | Öffnen Sie das Beispiel in examples/helphtml/. | |
| 6 | 6 | ||
| 7 | 7 | Dieses Projekt demonstriert, wie die HTML-Hilfekomponenten zu verwenden sind. Legen Sie sie einfach auf einem Formular in Ihrem Projekt ab. Richten Sie die Pfade ein und erzeugen Sie einige HTML-Seiten. Weisen Sie dann jedem Bedienelement in Ihrer Anwendung ein Hilfeschlüsselword (*HelpKeyword*) zu. | |
| 8 | 8 | ||
| 9 | 9 | Beachten Sie bitte auch den Abschnitt über die "CHM Hilfe" falls Sie an Stelle der HTML-Hilfedateien lieber CHM-Hilfedateien verwenden möchten. | |
| 10 | 10 | ||
| 11 | 11 | ## Hilfe - Grundlagen | |
| 12 | 12 | ||
| 13 | 13 | Die LCL - Hilfe besteht hauptsächlich aus zwei Teilen: den Hilfe-Datenbanken und einem Hilfe-Betrachter. Eine Hilfe-Datenbank enthält die Zuordnung der Schlüsselwörter (ID, node, message, pascal, ...) zur Hilfeseite (oder was auch immer). Der Hilfe-Betrachter wird von der Hilfe-Datenbank aufgerufen, um dem Benutzer die Hilfe zu zeigen. | |
| 14 | 14 | ||
| 15 | 15 | - Eine THelpDatabase verwaltet die Inhalte. Diese können aus einer Sammlung von HTML-Seiten oder fpdoc-XML-Dateien bestehen, aus einer CHM-Datei, einer Datenbank oder was auch immer. | |
| 16 | 16 | - Ein THelpViewer ist eine Komponente zum Anzeigen der Hilfe. Beispielsweise kann ein Viewer für den Mimetyp text/html einen Webbrowser starten. | |
| 17 | 17 | ||
| 18 | 18 | Wenn Hilfe angefordert wurde, durchsucht die LCL jede registrierte THelpDatabase und jede Datenbank kann eine Liste von Einträgen zurückliefern. Falls mehrere Einträge aufscheinen, ersucht die LCL den Benutzer, einen Eintrag auszuwählen. Dann beauftragt die LCL die Datenbank, diesen Hilfeeintrag anzuzeigen. Die Datenbank extrahiert den Hilfeinhalt und fragt die LCL nach einem Viewer der den Mimetyp des Inhalts unterstützt. Zuletzt zeigt der Viewer den Hilfeinhalt an. | |
| 19 | 19 | ||
| 20 | 20 | ## CHM | |
| 21 | 21 | ||
| 22 | 22 | In Lazarus 1.0 wurde die Unterstützung für eine kontextsensitive CHM-Hilfe für Ihre Anwendungen hinzugefügt. | |
| 23 | 23 | ||
| 24 | 24 | Ein enthaltenes Demonstrationsprogramm zeigt, wie Sie die kontextsensitive CHM-Hilfe und den lhelp CHM-Viewer (übrigens denselben, der auch von der IDE-Hilfe benutzt wird) einsetzen können. Sehen Sie dazu bitte lazarus/components/chmhelp/democontrol/. | |
| 25 | 25 | ||
| 26 | 26 | Schreiben Sie Ihre eigenen CHM-Dateien, z.B. mit dem etwas antiquierten Microsoft HTML Workshop oder mit den neuen Lazarus ChmMaker-Tools in lazarus/tools/chmmaker. Sie können ein CHMHelpDatabase-Steuerelement genau so benutzen wie das unten beschriebene HTMLHelpdatabase-Steuerelement. | |
| 27 | 27 | ||
| 28 | 28 | Der Vorteil des CHM Systems ist eine einzelne, kleinere Hilfedatei an Stelle von mehreren Dateien. Andererseits hat nicht jedes System einen CHM-Viewer. Deshalb könnten Sie lhelp mitliefern, einen CHM-Viewer, der in Pascal geschrieben ist. Den Quelltext finden Sie in den Lazarus-Quellen: (components/chmhelp/lhelp/lhelp.lpi). | |
| 29 | 29 | ||
| 30 | 30 | ### LHelp benutzen | |
| 31 | 31 | ||
| 32 | 32 | - Fügen Sie einen **TLHelpConnector** in Ihr Formular ein. | |
| 33 | 33 | - Legen Sie einen **LHelpPath** mit dem Namen und dem Speicherort der ausführbaren LHelp-Datei fest (dies kann absolut oder relativ zum Anwendungsverzeichnis sein). | |
| 34 | 34 | - Setzen Sie **AutoRegister** auf true. | |
| 35 | 35 | ||
| 36 | 36 | ``` pascal | |
| 37 | 37 | // Example with both chm file and LHelp.exe in Application folder. | |
| 38 | 38 | Procedure TForm1.FormCreate(Sender: TObject); | |
| 39 | 39 | Begin | |
| 40 | 40 | If FileExists(ChangeFileExt(Application.ExeName, '.chm')) Then | |
| 41 | 41 | Begin | |
| 42 | 42 | CHMHelpDatabase1.Filename := ChangeFileExt(Application.ExeName, '.chm'); | |
| 43 | 43 | CHMHelpDatabase1.Keyword := 'test'; | |
| 44 | 44 | CHMHelpDatabase1.AutoRegister:=True; | |
| 45 | 45 | ||
| 46 | 46 | LHelpConnector1.LHelpPath := IncludeTrailingBackSlash(ExtractFileDir(Application.ExeName)) + 'lhelp.exe'; | |
| 47 | 47 | LHelpConnector1.AutoRegister:=True; | |
| 48 | 48 | end | |
| 49 | 49 | Else | |
| 50 | 50 | mnuHelpMain.Enabled := False; | |
| 51 | 51 | End; | |
| 52 | 52 | ||
| 53 | 53 | Procedure TForm1.Button1Click(Sender: TObject); | |
| 54 | 54 | Begin | |
| 55 | 55 | If mnuHelpMain.Enabled Then | |
| 56 | 56 | ShowHelpOrErrorForKeyword('','test/Main.html'); | |
| 57 | 57 | //ShowTableOfContents; (Not implemented for TCHMHelpDatabase) | |
| 58 | 58 | End; | |
| 59 | 59 | ``` | |
| 60 | 60 | ||
| 61 | 61 | ## HTML | |
| 62 | 62 | ||
| 63 | 63 | Die LCL bietet zwei Komponenten mit HTML-Dateien als Hilfe: THTMLHelpDatabase und THTMLBrowserHelpViewer. Ein Beispiel für die HTML-Hilfe finden Sie unter: examples/helphtml/htmlhelp1.lpi. | |
| 64 | 64 | ||
| 65 | 65 | ### Einrichten der HTML-Hilfe für Ihre Anwendung | |
| 66 | 66 | ||
| 67 | - | ||
| 67 | + | Es ist einfach, Ihrer Anwendung eine HTML-Hilfe hinzuzufügen:  | |
| 68 | 68 | ||
| 69 | 69 | - Geben Sie eine **THTMLHelpDatabase** auf ein Formular. | |
| 70 | 70 | - Setzen Sie **AutoRegister** auf true. | |
| 71 | 71 | - Setzen Sie **KeywordPrefix** auf **HTML/**. Das bedeutet, dass alle Schlüsselwörter mit der Zeichenkette *HTML/* beginnen müssen. | |
| 72 | 72 | - Setzen Sie **BaseURL** auf **<file://html/>**. Dadurch werden die HTML-Dateien im Unterverzeichnis *html* gesucht. Sie können vollständige Pfade wie *<file:///usr/lib/yourhelp/>* oder einen URL wie *<http://www.yoursite.com/>* angeben. | |
| 73 | 73 | ||
| 74 | 74 | - Geben Sie einen **THTMLBrowserHelpViewer** auf das Formular. Diese Komponente kann den Standardbrowser des Benutzers starten. | |
| 75 | 75 | - Setzen Sie **AutoRegister** auf true. | |
| 76 | 76 | ||
| 77 | 77 | ### Erzeugen eines Hilfeeintrags | |
| 78 | 78 | ||
| 79 | 79 | - Legen Sie jetzt das Unterverzeichnis *html* an und erzeugen Sie eine HTML-Seite *html/edit1.html*. | |
| 80 | 80 | - Geben Sie ein TEdit auf das Formular. | |
| 81 | 81 | - Setzen Sie **HelpType** auf *htKeyword* | |
| 82 | 82 | - Setzen Sie **HelpKeyword** auf *html/edit1.html* | |
| 83 | 83 | ||
| 84 | 84 | Wenn Ihr Programm läuft, setzen Sie den Focus auf das Edit-Element und drücken Sie F1 für Hilfe. Unter OS X ist die Hilfetaste Cmd-? (oder Cmd+Shift+? abhängig von Ihrem Tastatur-Layout). Anmerkung: Einige Fenster-Manager / Widgetset - Kombinationen leiten F1 nicht an die LCL weiter. | |
| 85 | 85 | ||
| 86 | 86 | ## INF (mit dem DocView-Hilfe-Viewer des Toolkits fpGUI) | |
| 87 | 87 | ||
| 88 | 88 | Siehe den Beitrag und das Beispielprojekt im Lazarus-Forum. [1](https://forum.lazarus.freepascal.org/index.php/topic,27864.msg173887.html#msg173887) Es wird ein voll funktionsfähiges Beispiel einer LCL-Anwendung mit dem [DocView-Hilfe-Viewer](http://fpgui.sourceforge.net/screenshots_apps.shtml) des Toolkits [[fpGUI]] mit kontextsensitiver und allgemeiner Hilfe gezeigt. | |
| 89 | 89 | ||
| 90 | 90 | Beispielsweise: | |
| 91 | 91 | ||
| 92 | 92 | - Setzen Sie den Fokus auf ein bestimmtes Steuerelement und drücken Sie `F1`. Es wird das Hilfethema für dieses Steuerelement angezeigt. | |
| 93 | 93 | - Klicken Sie auf den Button Hilfe, um das Hilfethema für den Dialog / das Formular anzuzeigen. | |
| 94 | 94 | - Wählen Sie den Menüpunkt "Hilfe -\> Hilfe anzeigen". Daraufhin wird die allgemeine Anwendungshilfe und das erste Thema in der Hilfedatei angezeigt. | |
| 95 | 95 | ||
| 96 | 96 | --- | |
| 97 | 97 | *From the Free Pascal wiki, page "Add Help to Your Application/de", as it stood on 2020-03-09 after a change by Techno, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 98 | 98 | Category: Help and Docs/de | |
| 99 | 99 | Category: Tutorials/de |