WinHelp

WinHelp ( string strFileName, value Command, value Data = 0 );

Parameter

strFilename

Der Name der Hilfedatei welche aufgerufen werden soll.

Command

Das Kommando welches übergeben werden soll.

mögliche HELP_ - Konstanten:

HELP_COMMAND

führt ein Hilfe Makro aus. Data muß also eine Zeichenkette sein, welche den Namen des Makros spezifiziert. Wenn Data mehrere Makronamen enthält, müssen diese mit Strichpunkten voneinander getrennt sein. Sie müssen kurze Makronamen benutzen, da die Windows Hilfe keine langen Namen unterstützt.

HELP_CONTENTS

zeigt jenes Topic an, welches durch die Option "CONTENTS=" in der Sektion [OPTIONS] innerhalb der .hpj - Datei spezifiziert wurde. Dieses Kommando ist abwärtskompatibel. Neuere Applikationen sollten eine .cnt-Datei (Inhaltsdatei) benutzen und das Kommado HELP_FINDER benutzen. Data wird ignoriert.

HELP_CONTEXT

zeigt jene Topicnummer an, welche durch den numerischenden Wert von Data spezifiziert wurde. Data enthält also den entsprechenden Identifier.

HELP_CONTEXTPOPUP

zeigt jene Topicnummer in einem PopUp - Fenster an, welche durch den numerischenden Wert von Data spezifiziert wurde. Data enthält also den entsprechenden Identifier.

HELP_FINDER

zeigt die DialogBox "Inhalt" an. Data wird ignoriert.

HELP_FORCEFILE

stellt sicher, daß Windows die richtige Hilfedatei darstellt. Nur wenn die richtige Hilfedatei gefunden wurde, wird diese geöffnet, ansonsten passiert nichts. Data wird ignoriert.

HELP_HELPONHELP

zeigt "Hilfe zur Hilfe" an, sofern "WinHelp32.hlp" vorhanden ist. Data wird ignoriert.

HELP_KEY

zeigt jenes Topic an, dessen Keyword exakt mit der übergebenen Zeichenkette übereinstimmt. Data enthält also das Keyword. Werden mehrere Übereinstimmungen gefunden, wird die DialogBox "gefundene Topics" angezeigt. Mehrere Keywords müssen durch Strichpunkte getrennt werden.

HELP_PARTIALKEY

zeigt jenes Topic an, dessen Keyword exakt mit der übergebenen Zeichenkette übereinstimmt. Data enthält also das Keyword. Werden mehrere Übereinstimmungen gefunden, wird die DialogBox "gefundene Topics"
angezeigt. Um den Topic-Index direkt anzuzeigen, ist ein leere Zeichenkette zu übergeben. Mehrere Keywords müssen durch Strichpunkte getrennt werden.

HELP_QUIT

die Hilfe wird geschlossen. Data wird ignoriert.

HELP_SETCONTENTS

spezifiziert das Inhalts - Topic. Windows Help zeigt dieses Fenster an, wenn der Anwender auf "Inhalt" klickt und die Hilfedatei keine .cnt-Datei besitzt. Data enthält also den Topic - Namen.

Data

Abhängig von Command - der Übergabeparamter für das jeweilige Kommando
z.B. die TopicNummer

Bemerkung

Programmgesteuerter Aufruf einer Hilfe Datei.

Beispiel

if (Button1)
    WinHelp ("C:\Programme\Victory\victory.chm", HELP_CONTENTS);
end
die Inhaltsseite der Hilfe wird beim Start aufgeschlagen
   
if (Button2)
    WinHelp ("C:\Programme\Victory\victory.chm", HELP_QUIT);
end
die Hilfe wird geschlossen
   
if (Button3)
    WinHelp ("C:\Programme\Victory\victory.chm", HELP_FINDER);
end
der Suchindex der Hilfe wird beim Start aufgeschlagen

S onstige Funktionen

Siehe auch MailSend, MessageBeep, MessageBox, Printf, PrintDirect, Random, ReportConfirm, Round, ShellExecute, Sleep, SpeakText, SysDatabaseDeleteAllReports, ThrowReports, ValueChanging, ValueConvertAD, ValueConvertDA