Programmieren von HTML-Hilfefunktionen

Sie können Ihre Anwendung so programmieren, dass Benutzer die Möglichkeit haben, auf Ihr HTML-Hilfesystem zuzugreifen. Ein HTML-Hilfesystem kann aus einer oder mehreren Dateien bestehen. Dem Benutzer erscheint das Hilfesystem jedoch als Teil Ihrer Anwendung.

Mit den Befehlen SET HELP TO und SET TOPIC TO können Sie in Ihre Visual FoxPro-Anwendung eine grafikorientierte Hilfe bzw. eine Hilfe im DBF-Format integrieren. SET HELP TO gibt hierbei den Namen der benutzerdefinierten Hilfedatei für die Anwendung an. SET TOPIC TO legt das kennzeichnende Schlüsselwort für ein Thema in der benutzerdefinierten Hilfedatei fest.

Reservieren der F1-Taste

Wenn der Benutzer in Ihrer Anwendung die F1-Taste drückt, kann Visual FoxPro ein kontextbezogenes Hilfethema anzeigen. Hierzu weisen Sie einer Hilfekontextnummer ein Thema in Ihrer Hilfetabelle zu und geben diese Nummer als Wert für die HelpContextID-Eigenschaft des Formulars bzw. des Steuerelements ein. Wenn das Formular oder das Steuerelement den Fokus besitzt und der Benutzer die F1-Taste drückt, zeigt Visual FoxPro das entsprechende Hilfethema an.

Anmerkung   Standardmäßig ist die F1-Taste für die kontextbezogene Hilfe aktiviert. Da es sich hierbei um einen anerkannten Standard für die Hilfe handelt, wird empfohlen, diese Tastenzuordnung nicht zu verändern.

Einfügen von Hilfeschaltflächen in Formularen

Wenn Sie in Ihren Formularen eine Hilfeschaltfläche vorsehen, wird der Zugriff auf die Hilfe noch weiter vereinfacht. Dies ist insbesondere dann sinnvoll, wenn es sich bei den Benutzern um Neueinsteiger handelt.

Festlegen eines Kontextbezugs und Hinzufügen einer Hilfeschaltfläche

1. Geben Sie im Init-Ereignis des Formulars als HelpContextID-Eigenschaft für alle Formularobjekte den gleichen Wert ein, den Sie dem Hilfethema zugewiesen haben. Wenn diese Nummer z. B. den Wert 7 hat, können Sie den folgenden Befehl verwenden:

   THIS.SetAll("HelpContextID", 7)
   

2. Fügen Sie in Ihr Formular eine Befehlsschaltfläche ein.

3. Geben Sie für die Caption-Eigenschaft der Schaltfläche Hilfe ein.

4. Fügen Sie im Click-Ereignis der Befehlsschaltfläche den folgenden Befehl ein:

   HELP ID THIS.HelpContextID
   

   Tipp   Speichern Sie die Hilfeschaltfläche als Klasse, um sie später zu anderen Formularen hinzufügen zu können. Weitere Informationen zum Speichern von Objekten als Klassen finden Sie unter Erstellen von Formularen.

Vertreiben eines kompilierten HTML-Systems.

Zusätzlich zu der CHM-Datei, die Sie für das HTML-Hilfesystem erstellen, können Sie ein frei verfügbares Setup-Programm, Hhupd.exe, verwenden, mit dem die unten aufgeführten Laufzeitkomponenten der HTML-Hilfe installiert und registriert werden. Voraussetzung hierfür ist, dass auf dem Computer des Benutzers der Internet Explorer oder das Internet Explorer-Laufzeitmodul installiert ist.

Komponentenname	Beschreibung
Hhctrl.ocx	HTML-Hilfe ActiveX-Steuerelement
Itss.dll	DLL für die Handhabung der kompilierten HTML-Datei
Itircl.dll	DLL für die Volltextsuche
Hh.exe	HTML-Hilfe Anzeigemodul

Dieses Setup-Programm finden Sie im Unterverzeichnis Redist, das sich im Installationsverzeichnis von HTML Help Workshop befindet. Dieses Setup-Programm kann von anderen Setup-Programmen aufgerufen werden und in einem 'transparenten' Modus laufen, so dass es nicht mit einem bereits erstellten Setup-Programm kollidiert. Eine vollständige Liste der Befehlszeilenparameter erhalten Sie mit dem Befehl Hhupd.exe/?.

Siehe auch

Implementieren der HTML-Direkthilfe | WinHelp 4.0 | Erstellen der grafischen Hilfe | HTML-Hilfe | Erstellen von Hilfe im DBF-Format | SET HELP TO