DotNET Integration
Vorheriges Thema  Nächstes Thema 

Das Microsoft.NET (dot.net) Framework benutzt Html Hilfedateien (CHM) für die kontextbezogene Suche. Sie können die CHM Dateien, die Sie mit Fast-Help erstellt haben, ganz leicht in Ihre .NET Anwendung integrieren, sei sie in Visual Basic, C#, Delphi .NET oder einer anderen .NET Sprache geschrieben.


Als erstes platzieren Sie eine HelpProvider Komponente in Ihr Formular und geben Sie in den HelpNameSpace Eigenschaften den vollständigen Pfad Ihrer .chm Datei an, bzw. nur den .chm Namen, wenn sie sich im selben Verzeichnis wie Ihre .exe befindet.


Durch das Hinzufügen der HelpProvider Komponente werden im Formular für jede Befehlsschaltfläche zusätzliche Eigenschaften zugänglich. Im Folgenden ist beschrieben, wie Sie Hilfethemen mit den Befehlsschaltflächen verknüpfen:-


  1. Stellen Sie die ShowHelp Eigenschaft des Befehls auf Wahr.
  2. Stellen Sie die HelpNavigator Eigenschaft auf "Thema".
  3. Stellen Sie die Helpkeyword Eigenschaft auf "TestSeite.html", wobei TestSeite der Kontextstring in Fast-Help für das Thema ist, mit der Erweiterung "html". Sie können die Kontextstrings nachsehen, indem Sie in Fast-Help auf das "Eigenschaften" Register unter dem Editor klicken.
  4. Achten Sie darauf, dass Helpstringeigenschaften unausgefüllt bleibt


Wenn der User F1 drückt, zeigt Ihre Anwendung das Hilfethema zu dem Befehl an, der gerade hervorgehoben ist. Wenn der User auf das Fragezeichen in der Überschriftenleiste des Fensters klickt, und anschließend auf einen Befehl, wird das dem Befehl zugeordnete Hilfethema geöffnet. Ist der ShowHelp eines Befehls nicht auf Wahr gestellt, wird automatisch das Hilfethema des übergeordneten Befehls angezeigt. Wenn keine übergeordneten Befehle mit einem Hilfethema verknüpft sind, wird das Hilfethema des Formulars selbst angezeigt. Sollte auch dieses kein Thema haben, geschieht nichts. Es erscheint keine Fehlermeldung.


Um die Fragezeichenschaltfläche in der Titelleiste einzufügen, stellen Sie die Hilfebutton Eigenschaft des Formulars auf Wahr, und sowohl MaximiseBox als auch MinimizeBox auf Falsch.


Um die Hilfe programmatisch darzustellen, können Sie die statische Methode ShowHelp() aus der Hilfeklasse benutzen.


Um das Inhaltsverzeichnis anzuzeigen, wählen Sie: Help.ShowHelp(this,"helpfile.chm");


Um das Thema mit dem Kontextstring "TestSeite" anzuzeigen, wählen Sie:

Help.ShowHelp(this, "Hilfedatei.chm", HelpNavigator.Topic, "TestSeite.html");