所有應用程式均繼承自 TApplication,提供三種呼叫線上說明系統的方法:
呼叫 WinHelp,傳遞 HelpFile 檔名與主題編號(內容碼)。HelpFile 為字串屬性,若為空字串則回傳 False,否則 True。範例:點擊按鈕顯示 DATA.HLP 第 714 號主題:
procedure TForm2.Btn1Click(Sender: TObject);
begin
Application.HelpFile := 'DATA.HLP';
Application.HelpContext(714);
end;
傳遞 HelpFile 檔名與說明檔內唯一的「內容字串」。HelpFile 為空則回傳 False。範例:顯示 DELPHI.HLP 中 Default 屬性主題(內容字串 VclDefaultProperty):
procedure TForm1.Btn1Click(Sender: TObject);
begin
Application.HelpFile := 'DELPHI.HLP';
Application.HelpJump('VclDefaultProperty');
end;
對應 WinHelp API:BOOL WinHelp(HWND hwnd, LPCSTR lpszHelpFile, UINT fuCommand, DWORD dwData)。HelpCommand 傳遞 fuCommand(命令類型)與 dwData(參數)。
| 參數 | 類型 | 描述 |
|---|---|---|
| hwnd | HWND | 請求說明的視窗控制代碼 |
| lpszHelpFile | LPCSTR | 待顯示說明檔檔名 |
| fuCommand | UINT | 請求說明類型(見下表) |
| dwData | DWORD | 說明所需描述符或關鍵字 |
| 值 | 含義 |
|---|---|
| HELP_CONTEXT | 顯示 dwData 指定主題編號的說明 |
| HELP_CONTENTS | 顯示說明目錄主題 |
| HELP_HELPONHELP | 顯示說明系統自身說明,忽略其他參數 |
| HELP_INDEX | 顯示說明檔索引 |
| HELP_KEY | 顯示 dwData 指定關鍵字的說明 |
| HELP_MULTIKEY | 顯示多重關鍵字表中的關鍵字說明 |
| HELP_QUIT | 通知說明應用程式檔案不再使用 |
| HELP_SETINDEX | 設定 dwData 指定描述符為目前索引 |
dwData 含義視 fuCommand 而定:HELP_CONTEXT 為 32 位無號整數主題號;HELP_KEY 為關鍵字字串長指標;HELP_MULTIKEY 為 MULTIKEYHELP 結構長指標。
procedure TForm1.Btn1Click(Sender: TObject);
begin
Application.HelpFile := 'MyHelp.HLP';
Application.HelpCommand(HELP_CONTENTS, 0);
end;