Erstellen von Hilfedateien
unter Windows 3.x und Windows 95/98/NT

Last update: 08.08.2000

Diese Seite will nicht die Grundlagen der Winhelp-Programmierung aufzeigen, denn dafür gibt es ausreichend Literatur, sondern Tips & Tricks zeigen die in den unten aufgeführten Büchern nicht oder nur unzureichend beschrieben werden.

Jetzt neu ! Hilfedateien unter Windows98 werden nun mit HTML erstellt. Alle Möglichkeiten, die man bisher zum erstellen der eigenen Homepage nutzen konnte, stehen nun auch für die Erstellung einer Hifedatei zur Verfügung. Wie man die neuen Möglichkeiten auch unter Windows95 nutzen kann steht hier:
Erstellen von Hilfedateien unter Windows 95/98 mit HTML

 Literaturangabe

Die Beilagen enthalten natürlich nicht die neuesten Versionen der Compiler. Die gibt es aber hier:

Help Workshop Version 4.03 (32 bit): ftp://ftp.microsoft.com/Softlib/MSLFiles/hcwsetup.exe
Help Workshop Version 4.02 ??? (32 bit) für Word 97 mit neuer HYPERDOK in VBA programmiert:
http://mspress.microsoft.de/press/support.asp?mscssid=27146 Link not found
Nur die Hyperdok Vorlagendatei für Word 97. hyperdok.zip
Help Compiler Version 3.1 (16 bit) : ftp://ftp.microsoft.com/Softlib/MSLFiles/hc505.exe

Weitere interessante Links

• Easyhelp - Erstellung von Windows Help Files oder Internet Web Pages unter MS Word.
• AnetHelpTool - WYSIWYG Autorensystem.
• HTML to HLP (RTF) Konverter Neue URL - französische Homepage.
• HLP2RTF Konverter - Bestens geeignet um fremde HLP-Dateien auszuspionieren.
• OASIS SE (Freeware) - Sehr gutes Online Help-Erstellungstool. Sehr easy. Sehr gut. Beste Alternative zum Help Workshop. HCRTF.EXE, der Compiler wird noch benötigt. Mindestens Version 4.0

Links zu Anleitungen und Beschreibungen

• HelpMaster's WinHelp, HTML Help, Hypertext and Animation Site. By Josef Becker. [Top-Tip]

Demohilfe (32 bit)
Funktioniert nur mit der 32 bit Version des Compilers.

Ich habe eine Demo-Helpdatei erstellt, in der einige Vorgehensweisen zum erstellen von Hilfedateien erläutert werden. Darunter befinden sich Themen wie: Buttons, Editfelder, Makros, Eingangsmakros, Internetanbindung, Sekundäre Fenster, Grafiken mit Hotspots, Video und Audio einbinden und vieles mehr. Es werden alle Daten mitgeliefert (RTF, HPJ, CNT und alle DLL's). Die Größe des ZIP-Files beträgt 207 KByte.

Download der DemoHelp (32 bit)
für Windows 95/98/NT

Nach dem Download das ZIP-File in ein beliebiges Verzeichnis entpacken und die DEMO.RTF in Word ab Version 6.0 aufrufen. Die DEMO.HPJ im Help Workshop öffnen. Ich hoffe, Ihr könnt sehr viel für Eure Hilfeprojekte verwenden.
Wenn Ihr Vorschläge für weitere Themen habt, so schreibt doch eine Email an Holger Heinemann.  

Achtung ! Das Thema Nummer 13 verursacht unter Windows98 einen Programmabsturz !!!
Um den Fehler zu beheben muß die neue hsform.dll geladen
und in das Verzeichnis kopiert werden indem sich auch die DEMO.HLP befindet.

Tips & Tricks

Hotspots (Links) anders einfärben

Betriebssystem: alle
Wer in seiner Windows-Hilfe seine Querverweise (auch Hotspot oder Verknüpfung genannt) farblich ändern will, hat zwei Möglichkeiten:

1. global - d.h. die Einstellungen gelten für alle Helpdateien:

• Dazu öffne die WIN.INI in Deinem Windowsverzeichnis mit Notepad.
• sieh nach ob es einen [Windows Help] Abschnitt gibt.
• wenn nicht, füge ihn am Ende der Datei ein.
• danach kannst Du folgende Parameter für die Farben einfügen: JumpColor, PopupColor, MacroColor, IFJumpColor, IFPopupColor - alle sind auf GRÜN voreingestellt.

Beispiel um einen normalen Hotspot anders zu färben:

[Windows Help]
JumpColor=0 128 0

Die Zahlen stellen den Farbanteil (0 bis 255) von Rot, Grün und Blau dar.

2. lokal - d.h. nur für Deine erstellte Helpdatei

Die Standardfarbe muß unterdrückt werden.

• Hotspot unsichtbar: ein Prozentzeichen (%) vor der Themenkennung
• Hotspot ohne Farbe: ein Sternchen (*) vor der Themenkennung
• Hotspot andere Farbe: (%) oder (*) vor Themenkennung und Text mit einer anderen Farbe formatieren.

Logische Themenfolge einmal anders

Betriebssystem: alle
In Kapiteln können einzelne Themen mit einer logischen Themenfolge (z.B. +kapitel1:005, +kapitel1:010 ff.) versehen werden. Mit den BrowseButtons() kann dann von Thema zu Thema gesprungen werden. Wem das zu umständlich ist, kann stattdessen +browse eingeben, was ein blättern in der Reihenfolge erlaubt, wie die Themen in der RTF-Datei stehen.

Sprünge innerhalb eines Themas

Betriebssytem: alle
Bei Aufzählungen und besonders langen Texten kann man innerhalb eines Themas von zentraler Stelle aus Sprünge initiieren. Dabei müssen die Unterthemen mit einem Spaltenwechsel (STRG/SHIFT/RETURN) voneinander getrennt werden.
Beispiel einer RTF-Datei: SPRUNG.ZIP - 3,4 KByte
SPRUNG.ZIP in ein neues Verzeichnis entpacken und in Word ansehen oder aber kompilieren.

Audiodateien abspielen

Betriebssystem: Windows 95
Um Audiodateien (WAV) abspielen zu können, werden in den oben aufgeführten Büchern Beispiele gezeigt die den mciSendString verwenden. Diese Methode hat den Nachteil, das während des Abspielens keine weiteren Maus- oder Tastatureingaben mehr vorgenommen werden können.
Dieses Problem wird umgangen, wenn man den Audiorecorder von Windows aufruft und als Parameter /embedding angibt, der den Recorder unsichtbar im Hintergrund ablaufen läßt.
Text markieren, Hotspot aufrufen, Makro wählen und folgendes Makro in die Textbox eingeben: ExecProgram(`sndrec32.exe /embedding /play /close audio.wav',0) Dabei muß das erste einfache Anführungszeichen mit SHIFT und Taste neben ? ß und das zweite einfache Anführungszeichen mit SHIFT ' # eingegeben werden. Warum ???
Bitte beachten, das sich die Audiodatei dabei im gleichen Verzeichnis befindet wie die Helpdatei.

[Onlinehilfe (*.hlp)] [Onlinehilfe (*.chm)]

Email to: Holger Heinemann
© Copyright 1999 Holger Heinemann