[討論] setfunhelp函數的使用方法

(setfunhelp c:fname [helpfile [topic [command]]])
想請教論壇內老師&前輩們,關於setfunhelp函數的使用方法 , 另外在helpfile內該如何撰寫 ?

下面的範例定義了一個簡單函數，並使用 setfunhelp 函數使它與 AutoCAD 幫助文件 (acad.chm) 的 circle 主題聯繫起來~

(defun c:foo ()
(getstring "按下 F1 調用 foo 指令的幫助:")
)
(setfunhelp "c:foo" "acad.chm" "circle")
加載程式後，使用 foo 指令，然後按 F1 鍵顯示 circle 說明。

該樣的語句只是一個範例，而沒有實際意義。在實際使用中，可以創建自己的幫助文件，然後將幫助文件和函數聯繫起來。

定義名為 test 的函數：

指令： (defun c:test()(getstring "\nTEST: " )(princ))

C:TEST

將函數與幫助文件關聯起來，使用 HELP_PARTIALKEY fuCommand 和字符串「line」調用幫助：

指令： (setfunhelp "c:test" "acad.chm" "line")

"c:test"

執行 test 指令，並在指令行提示下按 F1 鍵。這時應出現幫助索引，其中「line」作為要查找的關鍵字出現在查找框中。

注意 使用 defun 函數定義 C:XXX 函數時，它會取消由 setfunhelp 註冊的同名函數（如果存在的話）。因此，只能在調用 defun 函數定義一個用戶定義的命令後，才能調用 setfunhelp 函數。


helpfile
字符串，幫助文件名稱。

這我看過 ~ 是說明文件內的東西
但他沒有範例,也沒說明自訂的說明檔(.AHP)該如何撰寫

語法:(setfunhelp c:fname [helpfile [topic [command]]])

範例:
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM")

在執行 C:MYCOMMAND 指令時按下[F1]鍵,
可以正確開啟 MYHELP.CHM 的第一個主題.

至於參數 [topic [command]],
對於 .chm的檔案可以這樣使用
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_CONTENTS")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_HELPONHELP")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_PARTIALKEY")

對於 .html的檔案可以這樣使用
(setfunhelp "C:MYCOMMAND" "MYHELP.HTML" "MYTOPIC" "HH_ALINK_LOOKUP")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.HTML" "MYTOPIC" "HH_DISPLAY_TOPIC")

pizg 寫到:語法:(setfunhelp c:fname [helpfile [topic [command]]])

範例:
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM")

在執行 C:MYCOMMAND 指令時按下[F1]鍵,
可以正確開啟 MYHELP.CHM 的第一個主題.

至於參數 [topic [command]],
對於 .chm的檔案可以這樣使用
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_CONTENTS")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_HELPONHELP")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.CHM" "MYTOPIC" "HELP_PARTIALKEY")

對於 .html的檔案可以這樣使用
(setfunhelp "C:MYCOMMAND" "MYHELP.HTML" "MYTOPIC" "HH_ALINK_LOOKUP")
或
(setfunhelp "C:MYCOMMAND" "MYHELP.HTML" "MYTOPIC" "HH_DISPLAY_TOPIC")

函數的使用我懂 ~ 說明文件內都有說明
但並沒有說到該說明檔的文件該如何撰寫,撰寫格式為何 ~