2.6.2.1 Beispiele für die Verwendung der Funktion WinHelp()

RTFC Benutzerhandbuch

  Home
  Wegweiser
  Braille
  Daisy
  Bestellung
  Download
  Kontakt
  Impressum

  Inhalt
  Index
  Suche

RTFC Benutzerhandbuch 2.6 Verknüpfen der Hilfe mit einem Anwendungsprogramm Index

2.6.2.1 Beispiele für die Verwendung der Funktion WinHelp()

Folgender Aufruf zeigt den Inhalt der Hilfe an:

WinHelp(hwnd, "programm.hlp", HELP_CONTENTS, 0L);

Beachten Sie, dass der Context String für den Inhalt der Hilfe in der Projektdatei definiert wird (siehe CONTENTS im Abschnitt [OPTIONS]).

Um den Hilfethemen-Dialog unter WinHelp 4.0 anzuzeigen müssen Sie folgenden Aufruf verwenden:

WinHelp(hwnd, "programm.hlp", HELP_FINDER, 0L);

Alternativ dazu können Sie auch folgenden Aufruf verwenden, der unter WinHelp 3.0 das Hypertext-Inhaltsverzeichnis und unter WinHelp 4.0 den Hilfethemen-Dialog anzeigt:

WinHelp(hwnd, "prog.hlp", HELP_COMMAND, (LPSTR) "Contents()");

Hilfethemen können entweder mit Ihrem Context String oder einer eindeutigen ID aufgerufen werden. Die ID wird im Abschnitt [MAP] der Projektdatei bzw. der dort eingebundenen Help Map-Datei (siehe "-H - Help Map-Datei (HM) für ein Anwendungsprogramm erzeugen") definiert.

Folgende Aufrufe zeigen jeweils ein bestimmtes Hilfethema an:

WinHelp(hwnd, "programm.hlp", HELP_COMMAND, (LPSTR) "JumpID(\"programm.hlp\",\"CONTEXT_STRING\")");

WinHelp(hwnd, "programm.hlp", HELP_CONTEXT, (DWORD) 4711);

Wenn die Hilfe-Datei über Schlüsselworte verfügt, können Hilfethemen auch über Schlüsselworte aufgerufen werden:

WinHelp(hwnd, "programm.hlp", HELP_KEY, "Symbolleiste");

Falls mehrere Themen für das gleiche Schlüsselwort vorhanden sind, wird nur das erste gefundene Thema angezeigt.

Falls eine Anwendung nicht mehr mit der Hilfe arbeiten will, muss sie dies ebenfalls über die Funktion WinHelp() mitteilen:

WinHelp(hwnd, "programm.hlp", HELP_QUIT, NULL);

Für weitere Informationen über die Funktion WinHelp() lesen Sie bitte in "Programming Tools for Windows" von Microsoft nach. Informationen über Makros bekommen Sie in "Win32 SDK Programmer's Reference, Volume 4" unter "Part 2: Tools Reference, Windows Help Statements and Macros" von Microsoft. Die Online-Hilfe zum Help Workshop unter Windows 9x (Hcw.hlp) bietet ebenfalls detaillierte Informationen.

Siehe auch:

Verknüpfen der Hilfe mit einem Anwendungsprogramm

2.6.2 Wie wird eine Hilfe aus einem Programm aufgerufen?
2.6.2.2 Beispiele für die Verwendung der Funktion HtmlHelp()