閱讀英文

共用方式為


MLHtmlHelp 函式

[此函式可透過 Windows XP 和 Windows Server 2003 取得。 在後續版本的 Windows 中,它可能會改變或無法使用。

顯示對應至目前 UI 語言設定的說明視窗。

語法

HWND MLHtmlHelp(
  _In_ HWND      hwndCaller,
  _In_ LPCTSTR   pszFile,
  _In_ UINT      uCommand,
  _In_ DWORD_PTR dwData,
  _In_ DWORD     dwCrossCodePage
);

參數

hwndCaller [in]

類型: HWND

呼叫此函式之父視窗的控制碼。

pszFile [in]

類型: LPCTSTR

緩衝區的指標,其中包含已編譯說明 (.chm) 檔案的完整路徑,或指定說明檔內的主題檔案。

uCommand [in]

類型: UINT

要完成的命令。 此函式直接支援 HH_DISPLAY_TOPICHH_DISPLAY_TEXT_POPUP。 如果是任何其他命令,呼叫會轉送而不 將 dwCrossCodePage 值轉送到 HtmlHelp

dwData [in]

類型: DWORD_PTR

根據 uCommand 參數的值,可能需要的任何資料。

dwCrossCodePage [in]

類型: DWORD

指出目前 UI 語言設定字碼頁的 DWORD 值,例如 CP_ACP。

傳回值

類型: HWND

根據指定的 uCommand 和結果, MLHtmlHelp 會傳回下列其中一項或兩者:

  • 說明視窗的控制碼 (hwnd) 。
  • NULL: 在某些情況下, Null 表示失敗;在其他情況下, Null 表示尚未建立說明視窗。

備註

如果目前語言的說明檔路徑發生問題,則會將呼叫轉送到 HtmlHelp 進行標準處理。

關閉說明視窗時,除非擁有者是桌面,否則焦點會返回擁有者。 如果 hwndCaller 是桌面,則作業系統會決定傳回焦點的位置。

此外,如果MLHtmlHelp從說明視窗傳送任何通知訊息,只要您已在說明視窗定義中啟用通知訊息追蹤,訊息就會傳送至hwndCaller

範例

下列範例會呼叫 HH_DISPLAY_TOPIC 命令,以開啟名為 Help.chm 的說明檔,並在名為 Mainwin 的說明視窗中顯示其預設主題。 一般而言,此命令中指定的說明視窗是標準 HTML 說明檢視器

HWND hwnd = HtmlHelp(GetDesktopWindow(),
                     "c:\\Help.chm::/Intro.htm>Mainwin",
                     HH_DISPLAY_TOPIC,
                     NULL,
                     CP_ACP);

注意

使用此函式時,請將裝載可執行檔的堆疊大小設定為至少 100k。 如果定義的堆疊大小太小,則建立以執行 HTML 說明的執行緒也會使用此堆疊大小來建立,而且作業可能會失敗。 您可以選擇性地從連結命令列移除 /STACK,同時移除可執行檔 DEF 檔案中的任何 STACK 設定, (預設堆疊大小在此案例中為 1MB) 。 您也可以使用 /Fnumber 編譯器命令來設定堆疊大小, (編譯器會將此專案傳遞至連結器作為 /STACK) 。

 

規格需求

需求
最低支援的用戶端
Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
DLL
Shlwapi.dll (5.0 版或更新版本)
Unicode 與 ANSI 名稱
MLHtmlHelpW (Unicode) 和 MLHtmlHelpA (ANSI)